Augustus Conversions API
The Conversions API from Augustus — 2 operation(s) for conversions.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/augustus:augustus-conversions-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Augustus Banking Conversions API
description: Augustus Banking API
version: 0.1.0
contact:
name: Augustus
url: https://docs.augustus.com
email: developer@augustus.com
servers:
- url: https://api.augustus.com
description: Production
- url: https://api.sandbox.augustus.com
description: Sandbox
security:
- BearerAuth: []
tags:
- name: Conversions
paths:
/v1/conversions:
get:
description: Returns a paginated list of conversions.
operationId: ConversionsController_list
parameters:
- name: limit
required: false
in: query
description: Number of results per page (1-100). Defaults to 10.
schema:
minimum: 1
maximum: 100
default: 10
type: integer
- name: cursor
required: false
in: query
description: Opaque cursor from a previous next_cursor.
schema:
type: string
- name: status
required: false
in: query
description: Filter by conversion status.
schema:
type: string
enum:
- pending
- completed
- failed
- name: source_currency
required: false
in: query
description: Filter by source currency code.
schema:
example: USD
type: string
enum:
- EUR
- GBP
- USD
- USDC
- name: target_currency
required: false
in: query
description: Filter by target currency code.
schema:
example: USDC
type: string
enum:
- EUR
- GBP
- USD
- USDC
responses:
'200':
description: List of conversions
content:
application/json:
schema:
$ref: '#/components/schemas/ListConversionsResponseDto'
summary: List conversions
tags:
- Conversions
post:
description: Starts a conversion.
operationId: ConversionsController_create
parameters:
- name: Idempotency-Key
in: header
description: Idempotency key for safe retries. Reusing a key with an identical request body returns the cached response. Reusing a key with a different body returns 409.
required: true
schema:
type: string
requestBody:
required: true
description: Conversion parameters
content:
application/json:
schema:
$ref: '#/components/schemas/CreateConversionBodyDto'
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ConversionResourceDto'
summary: Create conversion
tags:
- Conversions
/v1/conversions/{id}:
get:
description: Retrieves a conversion by ID.
operationId: ConversionsController_retrieve
parameters:
- name: id
required: true
in: path
description: Unique identifier of the conversion.
schema:
format: uuid
example: 550e8400-e29b-41d4-a716-446655440006
type: string
responses:
'200':
description: The conversion resource
content:
application/json:
schema:
$ref: '#/components/schemas/ConversionResourceDto'
summary: Retrieve conversion
tags:
- Conversions
components:
schemas:
ListConversionsResponseDto:
type: object
properties:
data:
type: array
items:
type: object
properties:
id:
type: string
format: uuid
description: Unique identifier of the conversion.
example: 550e8400-e29b-41d4-a716-446655440006
type:
type: string
description: Resource type discriminator.
enum:
- conversion
status:
type: string
enum:
- pending
- completed
- failed
description: Current status of the conversion.
source_amount:
type: string
description: Amount as a string decimal (e.g. "100.50").
example: '100.50'
target_amount:
type: string
description: Amount as a string decimal (e.g. "100.50").
example: '100.50'
source_account_id:
type: string
format: uuid
description: ID of the source account, or null.
example: 550e8400-e29b-41d4-a716-44665544000b
nullable: true
target_account_id:
type: string
format: uuid
description: ID of the target account, or null.
example: 550e8400-e29b-41d4-a716-44665544000c
nullable: true
metadata:
type: object
additionalProperties:
type: string
maxLength: 500
description: 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.
example:
invoice_id: INV-2026-0042
created_at:
type: string
format: date-time
description: ISO 8601 UTC timestamp when the conversion was created.
example: '2026-01-15T10:30:00Z'
updated_at:
type: string
format: date-time
description: ISO 8601 UTC timestamp when the conversion was last updated.
example: '2026-01-15T10:35:00Z'
completed_at:
type: string
format: date-time
description: ISO 8601 UTC timestamp when the conversion completed, or null.
example: '2026-01-15T10:36:00Z'
nullable: true
required:
- id
- type
- status
- source_amount
- target_amount
- source_account_id
- target_account_id
- metadata
- created_at
- updated_at
- completed_at
additionalProperties: false
has_more:
type: boolean
next_cursor:
type: string
example: eyJsYXN0X2lkIjoiNTUwZTg0MDAtZTI5Yi00MWQ0LWE3MTYtNDQ2NjU1NDQwMDA2In0
nullable: true
has_previous:
type: boolean
previous_cursor:
type: string
example: eyJsYXN0X2lkIjoiNTUwZTg0MDAtZTI5Yi00MWQ0LWE3MTYtNDQ2NjU1NDQwMDA2In0
nullable: true
required:
- data
- has_more
- next_cursor
- has_previous
- previous_cursor
additionalProperties: false
CreateConversionBodyDto:
type: object
properties:
source_account_id:
type: string
format: uuid
description: ID of the source account to debit.
example: 550e8400-e29b-41d4-a716-44665544000b
target_account_id:
type: string
format: uuid
description: ID of the target account to credit.
example: 550e8400-e29b-41d4-a716-44665544000c
source_amount:
type: string
pattern: ^\d+(\.\d+)?$
description: Amount as a string decimal (e.g. "100.50").
example: '100.50'
metadata:
type: object
propertyNames:
type: string
maxLength: 40
additionalProperties:
type: string
maxLength: 500
description: 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.
example:
invoice_id: INV-2026-0042
nullable: true
required:
- source_account_id
- target_account_id
- source_amount
additionalProperties: false
ConversionResourceDto:
type: object
properties:
id:
type: string
format: uuid
description: Unique identifier of the conversion.
example: 550e8400-e29b-41d4-a716-446655440006
type:
type: string
description: Resource type discriminator.
enum:
- conversion
status:
type: string
enum:
- pending
- completed
- failed
description: Current status of the conversion.
source_amount:
type: string
description: Amount as a string decimal (e.g. "100.50").
example: '100.50'
target_amount:
type: string
description: Amount as a string decimal (e.g. "100.50").
example: '100.50'
source_account_id:
type: string
format: uuid
description: ID of the source account, or null.
example: 550e8400-e29b-41d4-a716-44665544000b
nullable: true
target_account_id:
type: string
format: uuid
description: ID of the target account, or null.
example: 550e8400-e29b-41d4-a716-44665544000c
nullable: true
metadata:
type: object
additionalProperties:
type: string
maxLength: 500
description: 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.
example:
invoice_id: INV-2026-0042
created_at:
type: string
format: date-time
description: ISO 8601 UTC timestamp when the conversion was created.
example: '2026-01-15T10:30:00Z'
updated_at:
type: string
format: date-time
description: ISO 8601 UTC timestamp when the conversion was last updated.
example: '2026-01-15T10:35:00Z'
completed_at:
type: string
format: date-time
description: ISO 8601 UTC timestamp when the conversion completed, or null.
example: '2026-01-15T10:36:00Z'
nullable: true
required:
- id
- type
- status
- source_amount
- target_amount
- source_account_id
- target_account_id
- metadata
- created_at
- updated_at
- completed_at
additionalProperties: false
securitySchemes:
BearerAuth:
scheme: bearer
bearerFormat: JWT
type: http
description: Bearer token for authentication with Augustus Banking API
x-provenance:
method: harvested
publisher: Augustus
source: https://api.augustus.com/openapi/2026-05-01.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)