List payees - Infinity API

GET

/

payees

List payees

curl --request GET \
  --url https://sandbox-api.infinityapp.in/v1/payees \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "payee_c8pnahcrxqzd3z8d",
      "first_name": "Maria",
      "last_name": "Lopez",
      "email": "maria@example.com",
      "currency": "eur",
      "status": "invited",
      "send_invite": false,
      "onboarding_url": "https://…",
      "reference": "vendor-829",
      "metadata": {
        "invoice": "inv-1042"
      },
      "created_at": "2026-10-26T10:00:00Z",
      "updated_at": "2026-10-26T10:00:00Z"
    }
  ],
  "has_more": false
}

{
  "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": "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"
  }
}

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.

Query Parameters

limit

integer

default:20

How many to return.

Required range: 1 <= x <= 100

starting_after

string

The last id of the previous page. Returns the items after it.

status

enum<string>

invited: created; hasn't signed up yet.
details_pending: signed up; hasn't sent bank details yet.
verifying: details sent; checks are running.
active: can be paid.
inactive: can't be paid.

Available options:

invited,

details_pending,

verifying,

active,

inactive

Example:

"invited"

email

string

An exact match, to find a payee you already created.

Example:

"maria@example.com"

Response

Payees, newest first.

data

object[]

required

Show child attributes

has_more

boolean

required

Example:

false

List payees

curl --request GET \
  --url https://sandbox-api.infinityapp.in/v1/payees \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "payee_c8pnahcrxqzd3z8d",
      "first_name": "Maria",
      "last_name": "Lopez",
      "email": "maria@example.com",
      "currency": "eur",
      "status": "invited",
      "send_invite": false,
      "onboarding_url": "https://…",
      "reference": "vendor-829",
      "metadata": {
        "invoice": "inv-1042"
      },
      "created_at": "2026-10-26T10:00:00Z",
      "updated_at": "2026-10-26T10:00:00Z"
    }
  ],
  "has_more": false
}

{
  "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": "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"
  }
}