Get a webhook endpoint - Infinity API

GET

/

webhook-endpoints

/

{id}

Get a webhook endpoint

curl --request GET \
  --url https://sandbox-api.infinityapp.in/v1/webhook-endpoints/{id} \
  --header 'Authorization: Bearer <token>'

{
  "id": "webhook_qjvv94gq6e73azsa",
  "url": "https://acme.com/webhooks/infinity",
  "events": [
    "payout.paid",
    "payout.failed"
  ],
  "status": "enabled",
  "description": "Production payouts",
  "secret": "whsec_MfKQ9r8GKYqrTwjUPD8ILPZIo2LaLaSw",
  "created_at": "2026-10-26T10:00:00Z",
  "updated_at": "2026-10-26T10:00:00Z"
}

{
  "error": {
    "type": "authentication_error",
    "code": "wrong_environment",
    "message": "This is a live key. Use it on api.infinityapp.in.",
    "param": null,
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

Authorizations

Authorization

string

header

required

Your secret key: sk_test_… on the sandbox host, sk_live_… on live. A key on the wrong host gets a 401 wrong_environment. Keys are secret. Keep them on your server, never in a browser or app.

Path Parameters

id

string

required

Example:

"webhook_qjvv94gq6e73azsa"

Response

The endpoint. secret is null.

id

string

required

Example:

"webhook_qjvv94gq6e73azsa"

url

string

required

Example:

"https://acme.com/webhooks/infinity"

events

string[]

required

Event types, or ["*"] for every type, including ones added later.

Example:

["payout.paid", "payout.failed"]

status

enum<string>

required

Available options:

enabled,

disabled

description

string | null

required

Example:

"Production payouts"

secret

string | null

required

whsec_…, for checking signatures. Only in the create response; null everywhere else.

Example:

"whsec_MfKQ9r8GKYqrTwjUPD8ILPZIo2LaLaSw"

created_at

string<date-time>

required

Example:

"2026-10-26T10:00:00Z"

updated_at

string<date-time>

required

Example:

"2026-10-26T10:00:00Z"

Get a webhook endpoint

curl --request GET \
  --url https://sandbox-api.infinityapp.in/v1/webhook-endpoints/{id} \
  --header 'Authorization: Bearer <token>'

{
  "id": "webhook_qjvv94gq6e73azsa",
  "url": "https://acme.com/webhooks/infinity",
  "events": [
    "payout.paid",
    "payout.failed"
  ],
  "status": "enabled",
  "description": "Production payouts",
  "secret": "whsec_MfKQ9r8GKYqrTwjUPD8ILPZIo2LaLaSw",
  "created_at": "2026-10-26T10:00:00Z",
  "updated_at": "2026-10-26T10:00:00Z"
}

{
  "error": {
    "type": "authentication_error",
    "code": "wrong_environment",
    "message": "This is a live key. Use it on api.infinityapp.in.",
    "param": null,
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}