List KYC Addresses by Market ID

Get all KYC addresses associated with a market with pagination support.

Endpoint: GET /api/v1/integration/kyc-addresses/markets/{market_id}

Authentication: Required (Bearer token)

Required Headers:

Authorization: Bearer <access_token>
X-Target-Server: integration

Path Parameters

Parameter	Type	Required	Description
market_id	string (UUID)	Yes	Market ID

Query Parameters

Parameter	Type	Required	Description
page	integer	No	Page number (default: 1)
per_page	integer	No	Number of items per page (default: 20)
chain_id	integer	No	Filter by blockchain network ID (e.g., 1 = Ethereum Mainnet, 137 = Polygon)

Response

Status: 200 OK

Returns a paginated list of KYC addresses.

{
  "kyc_addresses": [
    {
      "id": "484c1ee9-eac9-4792-b4f1-f5036f6d88e7",
      "market_id": "262bed05-5a0e-4fff-8171-39fafab66b0c",
      "name": "kyc det",
      "address": "0x1234567890abcdef",
      "chain_id": 1,
      "created_at": "2025-12-23T21:37:10.358636Z",
      "updated_at": "2025-12-23T21:37:10.358636Z"
    },
    {
      "id": "dead60a2-40a3-4566-9891-4a045fb9d68c",
      "market_id": "262bed05-5a0e-4fff-8171-39fafab66b0c",
      "name": "Yeni KYC",
      "address": "0x82814921489124",
      "chain_id": 137,
      "created_at": "2025-12-16T15:47:08.993732Z",
      "updated_at": "2025-12-16T15:47:08.993732Z"
    }
  ],
  "total": 4,
  "page": 1,
  "per_page": 20
}

Example cURL Request

Without chain_id filter:

curl -X GET 'https://<base-url>/api/v1/integration/kyc-addresses/markets/262bed05-5a0e-4fff-8171-39fafab66b0c?page=1&per_page=20' \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Target-Server: integration"

With chain_id filter:

curl -X GET 'https://<base-url>/api/v1/integration/kyc-addresses/markets/262bed05-5a0e-4fff-8171-39fafab66b0c?page=1&per_page=20&chain_id=137' \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Target-Server: integration"