v8

OpenAPI 3.1.02026-08-033623795.0 MB
Company token transactions

List company token transactions

Returns a paginated list of token transactions for a user or company, depending on the authenticated actor, with optional filtering by user and transaction type.

Required permissions:

  • company_token_transaction:read
  • member:basic:read
  • company:basic:read
get/company_token_transactions

Query parameters

afterstring nullable

Returns the elements in the list that come after the specified cursor.

beforestring nullable

Returns the elements in the list that come before the specified cursor.

firstinteger nullable

Returns the first n elements from the list.

Example:42
lastinteger nullable

Returns the last n elements from the list.

Example:42
company_idstring required

The unique identifier of the company to list token transactions for.

Example:biz_xxxxxxxxxxxxxx
user_idstring nullable

Filter transactions to only those involving this specific user.

Example:user_xxxxxxxxxxxxx
transaction_type'add' | 'subtract' | 'transfer'

The type of token transaction

Response

A successful response

Example response

{
  "data": [
    {
      "amount": 6.9,
      "company": {
        "id": "biz_xxxxxxxxxxxxxx"
      },
      "created_at": "2023-12-01T05:00:00.401Z",
      "description": "Reward for completing onboarding",
      "idempotency_key": "txn_reward_usr_123_2024",
      "user": {
        "id": "user_xxxxxxxxxxxxx",
        "name": "John Doe",
        "username": "johndoe42"
      }
    }
  ]
}