---
title: "List submitted tax filings"
method: GET
path: "/api/v1/me/tax/filings"
tags: ["Taxes"]
---

# List submitted tax filings

`GET /api/v1/me/tax/filings`

## Request

- Base URL: `https://portal.eprospera.com`
- URL: `https://portal.eprospera.com/api/v1/me/tax/filings`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://portal.eprospera.com/api/oauth/authorize`
    - Token URL: `https://portal.eprospera.com/api/oauth/token` scopes: `eprospera:person.tax.read`
  - OAuth 2
    - Authorization code: `https://portal.eprospera.com/api/oauth/authorize`
    - Token URL: `https://portal.eprospera.com/api/oauth/token` scopes: `eprospera:entity.tax.read`
- TypeScript: <https://skmtc.dev/eprospera/apis/e-pro-spera-api/docs/api/v1/me/tax/filings/get.ts> (a function with typed inputs; its response is checked against the schema)

Account deactivation revokes personal API keys, including Agent Keys, and OAuth authorizations. Account reactivation requires new API keys, including new Agent Keys, and consent; previously issued credentials remain invalid.

## Query parameters

- `subject` union
  - 'personal'
  - string, uuid
- `type` 'income' | 'vat'
- `year` integer
- `limit` integer
- `cursor` string

## Response `200`

Cursor-paginated submitted tax filings.

- object
  - `data` TaxFiling[], required
    - `id` string, uuid, required
    - `subject` TaxSubject, required
      - `type` 'natural_person' | 'legal_entity', required
      - `id` string, uuid, required
      - `name` string, required
      - `residentPermitNumber` string, nullable, required: 14-digit Resident Permit Number.
    - `type` 'income' | 'vat', required
    - `period` object, required
      - `year` integer, required
      - `quarter` integer, nullable, required
    - `submittedAt` string, date-time, required
    - `amended` boolean, required
    - `currency` 'usd' | 'btc', required
    - `accountingMethod` string, nullable, required
    - `reported` object, required
      - `grossIncome` string, nullable, required
      - `taxCredit` string, nullable, required
      - `taxWithheld` string, nullable, required
    - `usdEquivalent` object, nullable, required
      - `grossIncome` string, nullable, required
      - `taxCredit` string, nullable, required
      - `taxWithheld` string, nullable, required
    - `taxLiability` string, nullable, required
    - `exchangeRate` object, nullable, required
      - `btcUsdRate` string, nullable, required
      - `capturedAt` string, date-time, nullable, required
      - `source` string, nullable, required
    - `invoice` object, nullable, required
      - `id` string, uuid, required
      - `status` string, required
    - `availableDocuments` string[], required
  - `meta` object, required
    - `nextCursor` string, nullable, required

## Other responses

- `400`: Validation error or precondition failure.
- `401`: Missing or invalid credential.
- `403`: Credential lacks the required scope (Agent Key) or insufficient OAuth scope.
- `404`: Resource does not exist or is invisible to the caller. The two are intentionally indistinguishable.
- `409`: Conflicting state (e.g. legal-entity name already taken).
- `429`: Rate limit exceeded. No `Retry-After` header is currently emitted; back off exponentially.
- `500`: Server error.

## Changes

- **2026-10-19** `271098460337`: 2 info
  - the security scope `eprospera:person.tax.read` was added to the endpoint's security scheme `oauth2`
  - the security scope `eprospera:entity.tax.read` was removed from the endpoint's security scheme `oauth2`
- **2026-10-14** `f68c9a4d8ec8`: 2 info
  - the security scope `eprospera:person.tax.read` was added to the endpoint's security scheme `oauth2`
  - the security scope `eprospera:entity.tax.read` was removed from the endpoint's security scheme `oauth2`
- **2026-10-14** `7d4bb4aede91`: 2 info
  - the security scope `eprospera:person.tax.read` was added to the endpoint's security scheme `oauth2`
  - the security scope `eprospera:entity.tax.read` was removed from the endpoint's security scheme `oauth2`
- **2026-10-08** `d6ef6f72daa1`: 2 info
  - the security scope `eprospera:person.tax.read` was added to the endpoint's security scheme `oauth2`
  - the security scope `eprospera:entity.tax.read` was removed from the endpoint's security scheme `oauth2`
- **2026-10-06** `7254e19987ac`: 2 info
  - the security scope `eprospera:person.tax.read` was added to the endpoint's security scheme `oauth2`
  - the security scope `eprospera:entity.tax.read` was removed from the endpoint's security scheme `oauth2`

[Operation history](https://skmtc.dev/eprospera/apis/e-pro-spera-api/changes/api/v1/me/tax/filings/get.md)

---

[API](https://skmtc.dev/eprospera/apis/e-pro-spera-api.md) - [All operations](https://skmtc.dev/eprospera/apis/e-pro-spera-api/llms.txt) - [OpenAPI document](https://skmtc.dev/eprospera/apis/e-pro-spera-api/revisions/271098460337?raw)