Get Invoice Transactions

get/v1/invoice-transactions/{invoice_transaction_id}

Fetches a single invoice transaction by its public id within the active workspace. Read only, no side effects. Returns 404 when the id is unknown or falls outside the caller's workspace scope.

Requires a bearer token: Authorization: Bearer <token>.

Path parameters

Name	Type	Required	Description
invoice_transaction_id	string <uuid>	Yes	Public UUID of the invoice transaction.e.g. e1f2a3b4-0000-4000-8000-0000000000ab

Query parameters

Name	Type	Required	Description
workspaceId	string <uuid>	No	Explicit workspace scope. The authenticated user must hold an active membership in this workspace. Defaults to the session workspace when omitted.e.g. a1b2c3d4-0000-4000-8000-000000000001

Request

cURL

curl -X GET https://api.wellapp.ai/v1/invoice-transactions/{invoice_transaction_id} \
  -H "Authorization: Bearer $WELL_API_TOKEN"

Responses

200 — The requested invoice transaction.

{
  "data": {
    "type": "invoice_transaction",
    "id": "e1f2a3b4-0000-4000-8000-0000000000ab",
    "attributes": {
      "invoice_transaction_id": "e1f2a3b4-0000-4000-8000-0000000000ab",
      "amount": 1200,
      "currency": "USD",
      "accounting_amount": 1200,
      "accounting_currency": "USD",
      "allocation_type": "full",
      "is_partial": false,
      "created_at": "2026-04-28T11:00:00Z",
      "updated_at": "2026-04-28T11:00:00Z",
      "deleted_at": null
    },
    "relationships": {
      "invoice": {
        "data": {
          "type": "invoice",
          "id": "00000000-0000-4000-8000-000000000001"
        }
      },
      "transaction": {
        "data": {
          "type": "transaction",
          "id": "00000000-0000-4000-8000-000000000001"
        }
      },
      "subscription": {
        "data": {
          "type": "subscription",
          "id": "00000000-0000-4000-8000-000000000001"
        }
      },
      "exchange_rate": {
        "data": {
          "type": "exchange_rate",
          "id": "00000000-0000-4000-8000-000000000001"
        }
      }
    }
  }
}

401 — Unauthorized

{
  "code": "UNAUTHORIZED",
  "status": 401,
  "title": "Unauthorized",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}

404 — Not found

{
  "code": "NOT_FOUND",
  "status": 404,
  "title": "Not Found",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}