Skip to content

Add cost to transaction

Endpoint

POST /v1/transactions/{transactionId}/costs

Authentication

Requires Bearer token authentication.

Path Parameters

Parameter	Type	Required	Description
`transactionId`	string	Yes	Transaction ID

Request Body

{
  "fiatAmount": "0.25",
  "fiatAssetSymbol": "USD",
  "isEstimate": false,
  "supersedesCostId": "123e4567-e89b-12d3-a456-426614174000",
  "costDetails": {
    "provider": "anthropic",
    "model": "claude-3-5-sonnet-20241022",
    "inputTokens": 1000,
    "outputTokens": 5000,
    "inputCostUsd": "0.05",
    "outputCostUsd": "0.20"
  }
}

cURL Example

curl -X POST "https://api.sapiom.ai/v1/transactions/{transactionId}/costs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fiatAmount": "0.25",
    "fiatAssetSymbol": "USD",
    "isEstimate": false,
    "supersedesCostId": "123e4567-e89b-12d3-a456-426614174000",
    "costDetails": {
        "provider": "anthropic",
        "model": "claude-3-5-sonnet-20241022",
        "inputTokens": 1000,
        "outputTokens": 5000,
        "inputCostUsd": "0.05",
        "outputCostUsd": "0.20"
    }
}'

Response

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "transactionId": "123e4567-e89b-12d3-a456-426614174000",
  "tenantId": "123e4567-e89b-12d3-a456-426614174000",
  "paymentTransactionId": "123e4567-e89b-12d3-a456-426614174000",
  "fiatAmount": "0.25",
  "fiatAssetId": "123e4567-e89b-12d3-a456-426614174000",
  "isEstimate": false,
  "isActive": true,
  "supersedesCostId": "123e4567-e89b-12d3-a456-426614174000",
  "supersededAt": "2024-01-15T10:30:00Z",
  "costDetails": {
    "provider": "anthropic",
    "model": "claude-3-5-sonnet-20241022",
    "inputTokens": 1000,
    "outputTokens": 5000
  },
  "createdAt": "2024-01-15T10:00:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}

Error Responses

Status	Code	Description
400	-	Invalid request data
401	-	Unauthorized - invalid or missing API key
404	-	Transaction not found

See API Introduction for error handling details.

What’s Next?