Docs

Fincore · API reference · Webhooks

Retrieve a client webhook

GET /v1/clients/{clientId}/webhooks/{id}
Try it ▸

Base URL https://apicore.stg.finch.lat · operationId getClientWebhook

Returns details for a specific webhook owned by the client.

Authorization

bearerAuth Bearer token

JWT bearer token created from client credentials. Use the Authentication guide to generate a token before calling protected endpoints.

Path parameters

clientId string (uuid) required

Client UUID that owns the webhook.

id string (uuid) required

Webhook UUID.

Responses

200 Webhook found application/json
id string (uuid) required

Webhook configuration UUID.

clientId string (uuid) required

Client UUID that owns the webhook.

url string (uri) required

Destination URL where Monato sends webhook events.

token string

Secret configured for webhook delivery.

webhookType string required

Type of events delivered to this webhook.

MONEY_IN STATUS_UPDATE CEP REPORT REFUND
webhookStatus string required

Current webhook lifecycle status.

ACTIVE INACTIVE
createdAt string (date-time)

Timestamp when the webhook configuration was created.

updatedAt string (date-time)

Timestamp when the webhook configuration was last updated.

deletedAt string | null

Timestamp when the webhook configuration was deleted, or null.

blockedAt string | null

Timestamp when the webhook configuration was blocked, or null.

deletedBy string | null

Identifier of the actor that deleted the webhook, or null.

blockedBy string | null

Identifier of the actor that blocked the webhook, or null.

401 Missing, expired, invalid, or environment-mismatched API key or bearer token. See Authentication. application/json
code integer required

gRPC status code mapped to HTTP.

message string required

General error message.

details array of ErrorDetail required

Detailed error causes returned by the service.

reason details[].reason string required

Machine-readable error category.

DATA_ERROR FAILED_PRECONDITION MISSING_REQUIRED_FIELDS RESOURCE_NOT_FOUND UNAUTHORIZED PERMISSION_DENIED UNIQUE_VIOLATION INTERNAL
domain details[].domain string required

Service domain that produced the error.

metadata details[].metadata object required

Additional error metadata, including the detailed message and HTTP code.

error_detail details[].metadata.error_detail string

Human-readable detail returned by the service.

http_code details[].metadata.http_code string

HTTP status code associated with this error.

error_code details[].metadata.error_code string

Optional internal error catalog code when available.

404 Webhook was not found for the supplied client. application/json
code integer required

gRPC status code mapped to HTTP.

message string required

General error message.

details array of ErrorDetail required

Detailed error causes returned by the service.

reason details[].reason string required

Machine-readable error category.

DATA_ERROR FAILED_PRECONDITION MISSING_REQUIRED_FIELDS RESOURCE_NOT_FOUND UNAUTHORIZED PERMISSION_DENIED UNIQUE_VIOLATION INTERNAL
domain details[].domain string required

Service domain that produced the error.

metadata details[].metadata object required

Additional error metadata, including the detailed message and HTTP code.

error_detail details[].metadata.error_detail string

Human-readable detail returned by the service.

http_code details[].metadata.http_code string

HTTP status code associated with this error.

error_code details[].metadata.error_code string

Optional internal error catalog code when available.

This request is in the Monato · Fincore Postman collection, folder Webhooks.Download collection

Request

curl -X GET "https://apicore.stg.finch.lat/v1/clients/{clientId}/webhooks/{id}" \
  -H "Authorization: Bearer $TOKEN"

Response

{
  "id": "29806117-2b15-4682-87f0-350e6695fe91",
  "clientId": "c2d1d1e3-3340-4170-980e-e9269bbbc551",
  "url": "https://example.com/webhook",
  "token": "secretToken0123",
  "webhookType": "MONEY_IN",
  "webhookStatus": "ACTIVE",
  "createdAt": "2025-04-03 13:40:54.056794-06:00",
  "updatedAt": "2025-04-03 13:40:54.056794-06:00",
  "deletedAt": null,
  "blockedAt": null,
  "deletedBy": null,
  "blockedBy": null
}