Skip to main content
GET
/
v1
/
participations
/
{id}
Get a participation for the authenticated partner and user
curl --request GET \
  --url https://api.coinlist.co/v1/participations/{id} \
  --header 'Authorization: Bearer <token>'
{
  "amount": "<string>",
  "amount_string": "<string>",
  "asset": {
    "code": "<string>",
    "fractional_digits": 123,
    "id": "<string>",
    "name": "<string>"
  },
  "chain": "<string>",
  "id": "05edea81-98a7-4582-aa7c-040d57cb1858",
  "object": "participation",
  "offer_id": "<string>",
  "offer_option_id": "<string>",
  "status": "prepared",
  "inserted_at": "2025-01-01T00:00:00.000000Z",
  "updated_at": "2025-01-01T00:00:00.000000Z",
  "wallet_address": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.coinlist.co/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

OAuth 2.0 authorization and token endpoints

Path Parameters

id
string
required

Participation ID

Response

Successful response.

An offer participation

amount
string
required

The participation amount

amount_string
string
required

The participation amount formatted as a human-readable string

asset
object
required

The asset details for the participation

chain
string
required

The chain for the participation contract

id
string
required

Unique identifier for the object.

Example:

"05edea81-98a7-4582-aa7c-040d57cb1858"

object
enum<string>
required

String representing the object's type. Objects of the same type share the same value.

Available options:
participation
offer_id
string
required

The ID of the offer

offer_option_id
string
required

The ID of the offer option

status
enum<string>
required

The participation status

Available options:
prepared,
pending,
submitted,
completed,
failed,
remit_submitted,
remitted,
remit_failed
inserted_at
string<date-time>

When the participation was created

Example:

"2025-01-01T00:00:00.000000Z"

updated_at
string<date-time>

When the participation was last updated

Example:

"2025-01-01T00:00:00.000000Z"

wallet_address
string | null

The wallet address for the participation