---
title: "List conversions"
method: GET
path: "/v1/conversions"
tags: ["Conversions"]
---

# List conversions

`GET /v1/conversions`

## Request

- Base URL: `https://api.augustus.com`
- URL: `https://api.augustus.com/v1/conversions`
- Auth: HTTP bearer

Returns a paginated list of conversions.

## Query parameters

- `limit` integer
- `cursor` string
- `status` 'pending' | 'completed' | 'failed'
- `source_currency` 'EUR' | 'GBP' | 'USD' | 'USDC'
- `target_currency` 'EUR' | 'GBP' | 'USD' | 'USDC'

## Response `200`

List of conversions

- ListConversionsResponseDto
  - `data` object[], required
    - `id` string, uuid, required: Unique identifier of the conversion.
    - `type` 'conversion', required: Resource type discriminator.
    - `status` 'pending' | 'completed' | 'failed', required: Current status of the conversion.
    - `source_amount` string, required: Amount as a string decimal (e.g. "100.50").
    - `target_amount` string, required: Amount as a string decimal (e.g. "100.50").
    - `source_account_id` string, uuid, nullable, required: ID of the source account, or null.
    - `target_account_id` string, uuid, nullable, required: ID of the target account, or null.
    - `metadata` object, required: Set of up to 50 key-value string pairs you can attach to store structured information, such as correlating this resource with an object in your own system. Keys may be up to 40 characters and values up to 500 characters.
    - `created_at` string, date-time, required: ISO 8601 UTC timestamp when the conversion was created.
    - `updated_at` string, date-time, required: ISO 8601 UTC timestamp when the conversion was last updated.
    - `completed_at` string, date-time, nullable, required: ISO 8601 UTC timestamp when the conversion completed, or null.
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required
  - `has_previous` boolean, required
  - `previous_cursor` string, nullable, required

## Changes

- **2026-10-16** `f7ded6c181ab`: 1 info
  - endpoint added
- **2026-08-21** `79d607871de9`: 4 breaking, 1 info
  - removed the required property `data/items/failure` from the response with the `200` status
  - removed the required property `data/items/quote_id` from the response with the `200` status
  - removed the required property `data/items/source_currency` from the response with the `200` status
  - removed the required property `data/items/target_currency` from the response with the `200` status
  - …1 more
- **2026-08-17** `3ed0a0aba68b`: 8 breaking, 8 info
  - removed the enum value `BTC` from the `query` request parameter `source_currency`
  - removed the enum value `BTC` from the `query` request parameter `target_currency`
  - removed the enum value `ETH` from the `query` request parameter `source_currency`
  - removed the enum value `ETH` from the `query` request parameter `target_currency`
  - …12 more
- **2026-07-13** `d92a4abea6c4`: 6 warning, 6 info
  - added the new `ETH` enum value to the `data/items/source_currency` response property for the response status `200`
  - added the new `ETH` enum value to the `data/items/target_currency` response property for the response status `200`
  - added the new `POL` enum value to the `data/items/source_currency` response property for the response status `200`
  - added the new `POL` enum value to the `data/items/target_currency` response property for the response status `200`
  - …8 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/augustus/apis/ivy-api/changes/v1/conversions/get.md)

---

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