Sign in
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

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

beforestring

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

firstinteger

Returns the first n elements from the list.

Example:42
lastinteger

Returns the last n elements from the list.

Example:42
user_idstring

Filter transactions to only those involving this specific user.

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

The type of token transaction

account_idstring required

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

Example:biz_xxxxxxxxxxxxxx

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"
      }
    }
  ]
}

Changes

Changed in 2 of the 74 revisions of this API.214

  • 697924df40d111See the full diff
    • ▲

      added the new required query request parameter account_id

      new-required-request-parameter

    • ●

      deleted the query request parameter company_id

      request-parameter-removed

    This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • f67a043e319014See the full diff
    • ▲

      the query request parameter transaction_type was restricted to a list of enum values

      request-parameter-became-enum

    • ○

      added the new enum value add to the query request parameter transaction_type

      request-parameter-enum-value-added

    • ○

      added the new enum value subtract to the query request parameter transaction_type

      request-parameter-enum-value-added

    • ○

      added the new enum value transfer to the query request parameter transaction_type

      request-parameter-enum-value-added

    • ○

      for the query request parameter transaction_type, the type was generalized from no type to string

      request-parameter-type-generalized

Of the 74 revisions, 1 has no diff computed.