---
title: "Get Earnings History"
method: GET
path: "/earnings/{identifier}"
tags: ["Individuals"]
---

# Get Earnings History

`GET /earnings/{identifier}`

Retrieves earnings history from platform work (e.g., Uber, DiDi) for an individual identified by an 18-char CURP. Returns monthly earnings data with pagination support.

## Path parameters

- `identifier` string, required

## Query parameters

- `page` integer
- `items_per_page` integer

## Response `200`

Earnings history for the identifier.

- EarningsResponse
  - `identifier` string — The identifier (CURP or RFC) associated with the earnings data.
  - `updated_at` string, date-time — Timestamp of when the earnings data was last updated.
  - `earnings_history` EarningsPeriod[] — Array of earnings records by period.
    - `period` string — Period of earnings in YYYY-MM format.
    - `amount` number, double — Total earnings amount for the period.
    - `currency` string — Currency code for the earnings amount.
    - `platform` string — Platform or service where earnings were generated (e.g., uber, didi).
  - `pagination` Pagination
    - `page` integer — The current page number.
    - `items_per_page` integer — The number of items returned per page.
    - `total_items` integer — The total number of items available.
    - `total_pages` integer — The total number of pages available.

## Other responses

- `401` — Unauthorized - Invalid or missing API key.

---

[API](https://skmtc.net/burodeingresos/apis/bur-de-ingresos-api.md) · [All operations](https://skmtc.net/burodeingresos/apis/bur-de-ingresos-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/burodeingresos/bur-de-ingresos-api/versions/59e48cdbdd84/schema)