---
title: "Get a Platform Settlement"
method: GET
path: "/payables/platform_settlements/{id}"
tags: ["Platform Settlements"]
---

# Get a Platform Settlement

`GET /payables/platform_settlements/{id}`

## Request

- Base URL: `https://api.justifi.ai/v1`
- URL: `https://api.justifi.ai/v1/payables/platform_settlements/{id}`
- Auth: none declared. Required headers: `Authorization`
- TypeScript: <https://skmtc.dev/justifi/apis/justifi-api-documentation/docs/payables/platform_settlements/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required

## Response `200`

Successfully retrieved the settlement

- object: the standard JustiFi response envelope for a single record
  - `id` string, required: the object id, also found in the data object
  - `type` string, required: the object type
  - `data` object, required: One disbursement between JustiFi and your platform: when it happens, how much, which way the money goes, and the reference to reconcile it against your bank statement. A settlement is **declared and then recorded**. It is `scheduled` with a frozen amount before any money moves, and only reaches `paid` once it has. A scheduled settlement is a statement of intent, not a promise — `failed` and `canceled` can still take it away.
    - `id` string: unique settlement id
    - `type` string: the object type, matching the enclosing envelope's `type`
    - `platform_account_id` string: the platform this settlement is between JustiFi and
    - `status` 'scheduled' | 'in_transit' | 'paid' | 'failed' | 'canceled' | 'forwarded': where the disbursement is in its lifecycle. `scheduled` — the amount is frozen and the disbursement is queued to be paid; `in_transit` — instructed, with a reference attached, not yet confirmed; `paid` — the money moved; `failed` — it did not, and the balance it covered is owed again; `canceled` — withdrawn before it moved, same effect; `forwarded` — a later settlement took over what this one failed to pay.
    - `direction` 'paid_out' | 'charged': which way the money goes. `paid_out` — JustiFi pays your platform its accrued balance; `charged` — JustiFi collects, because the fees it levied over the period exceeded the ones your platform earned. Read this rather than a sign: `amount_cents` is always positive.
    - `amount_cents` integer: the amount of the disbursement, always positive — `direction` says which way it goes
    - `currency` 'usd'
    - `entries_count` integer: how many platform ledger entries this settlement covers, its own balancing entry included. To read the entries themselves, list `/v1/payables/platform_ledger` and match on `settlement_id`.
    - `ledger_entry_id` string: the `settlement` entry on your platform ledger that balances what this covers
    - `external_reference` string, nullable: the ACH, wire or manual reference for the money movement — what to match against your bank statement. Null until the disbursement is instructed.
    - `scheduled_at` string, date-time: when the amount was frozen and the disbursement was queued
    - `recorded_at` string, date-time, nullable: when the money moved; null until it has
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `page_info` unknown, required

## Other responses

- `400`: The request was malformed, failed validation, or referenced a resource that cannot be used in its current state — for example scheduling a payment to a payee that is not active, or creating anything under a payer account that is not active. When the failure is field-level, `error.details` carries one array of messages per rejected attribute.
- `401`: The access token is missing, expired, or invalid.
- `403`: The credentials are valid but not permitted to access this resource.
- `404`: No resource exists for the given id (within the scoped payer account).
- `429`: The rate limit has been exceeded. Back off and retry after the interval indicated by the `Retry-After` header.

---

[API](https://skmtc.dev/justifi/apis/justifi-api-documentation.md) - [All operations](https://skmtc.dev/justifi/apis/justifi-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/justifi/apis/justifi-api-documentation/revisions/dd9f3fed7e46?raw)