---
title: "Retrieve commission"
method: GET
path: "/api/v1/commissions/{id}"
tags: ["Commissions"]
---

# Retrieve commission

`GET /api/v1/commissions/{id}`

Retrieve a commission by id

Returns commission details for the authenticated developer.

## Path parameters

- `id` string, required

## Response `200`

Commission details

- CommissionResponse — A commission earned (or owed) on a completed checkout intent.
  - `finalizedAt` string, date-time — Time the commission moved to a terminal status. Unset until finalized.
  - `updatedAt` string, date-time, required — Time the commission last changed (e.g. status transition).
  - `createdAt` string, date-time, required — Time the commission was first recorded.
  - `ryeFee` Money, required
    - `currencyCode` string, required
    - `amountSubunits` integer, required
  - `developerCommission` Money, required
    - `currencyCode` string, required
    - `amountSubunits` integer, required
  - `settlementDirection` 'rye_owes_developer' | 'developer_owes_rye', required — Direction of settlement: who owes whom once the commission is finalized.
  - `status` 'pending' | 'confirmed' | 'updated' | 'finalized' | 'refunded' | 'expired', required — Lifecycle status of a commission record.
  - `type` 'surcharge' | 'promo_arbitrage' | 'discount_code' | 'affiliate' | 'out_of_band', required — Type of commission earned on an order. Canonical definition used by both the API contract and the internal `@rye-com/ci-commissions` package.
  - `checkoutIntentId` string, required — The checkout intent this commission was generated from.
  - `id` string, required — Unique identifier for this commission.

## Other responses

- `401` — Authentication Failed
- `404` — Not Found

---

[API](https://skmtc.dev/rye-com/apis/universal-checkout-api.md) · [All operations](https://skmtc.dev/rye-com/apis/universal-checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rye-com/universal-checkout-api/revisions/175c7f9e090e/schema)