Elastic Path Currencies API
:::caution - There is a hard limit of 10 currencies per store. :::
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/elastic-path-currencies-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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: Introduction Currencies API
description: In your store, you can display prices to customers in their local currency.
contact:
name: Elastic Path
url: https://elasticpath.com
license:
name: MIT
url: assets/LICENSE
version: 26.0225.7248250
x-version-timestamp: 2026-02-25 21:31:11+00:00
servers:
- url: https://useast.api.elasticpath.com
description: US East Production Server
variables: {}
- url: https://euwest.api.elasticpath.com
description: EU West Production Server
variables: {}
security:
- bearerAuth: []
tags:
- name: Currencies
description: ':::caution
- There is a hard limit of 10 currencies per store.
:::'
paths:
/v2/currencies:
parameters: []
get:
tags:
- Currencies
summary: Get all Currencies
description: Fetch all currencies.
operationId: getAllCurrencies
parameters:
- name: page[offset]
in: query
description: The number of records to offset the results by.
style: form
explode: true
schema:
type: string
example: '0'
- name: page[limit]
in: query
description: The number of records per page.
style: form
explode: true
schema:
type: string
example: '10'
responses:
'200':
description: OK
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/Response.Data'
- properties:
data:
type: array
items:
$ref: '#/components/schemas/Response.Currency'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Response.Error'
example:
errors:
- status: 400
title: Bad Request
detail: The request was invalid
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Response.Error'
example:
errors:
- status: 401
title: Unauthorized
deprecated: false
post:
tags:
- Currencies
summary: Create a Currency
description: Create a currency.
operationId: createACurrency
parameters: []
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/Request.CreateCurrencies'
- example:
- data:
code: GBP
decimal_places: 2
decimal_point: .
default: true
enabled: true
exchange_rate: 1
format: £{price}
thousand_separator: ','
type: currency
examples:
GBP:
value:
data:
code: GBP
decimal_places: 2
decimal_point: .
default: true
enabled: true
exchange_rate: 1
format: £{price}
thousand_separator: ','
type: currency
USD:
value:
data:
code: USD
decimal_places: 2
decimal_point: .
default: true
enabled: true
exchange_rate: 1
format: ${price}
thousand_separator: ','
type: currency
required: false
responses:
'201':
description: Created
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/Response.Data'
- properties:
data:
$ref: '#/components/schemas/Response.Currency'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Response.Error'
example:
errors:
- status: 400
title: Currency already exists
detail: The specified currency code already exists
'422':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Response.Error'
example:
errors:
- status: 422
title: Currency limit reached
detail: You have reached the maximum allowed currency limit of 10
deprecated: false
/v2/currencies/{currencyID}:
parameters: []
get:
tags:
- Currencies
summary: Get a Currency
description: Fetch a currency by its ID.
operationId: getACurrency
parameters:
- name: currencyID
in: path
description: The ID for the requested currency.
required: true
style: simple
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/Response.Data'
- properties:
data:
$ref: '#/components/schemas/Response.Currency'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Response.Error'
example:
errors:
- status: 400
title: Bad Request
detail: The request was invalid
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Response.Error'
example:
errors:
- status: 401
title: Unauthorized
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/Response.Error'
example:
errors:
- status: 404
title: Currency not found
detail: The requested currency could not be found
deprecated: false
put:
tags:
- Currencies
summary: Update a Currency
description: Update a currency.
operationId: updateACurrency
parameters:
- name: currencyID
in: path
description: The ID for the requested currency.
required: true
style: simple
schema:
type: string
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/Request.UpdateCurrencies'
- example:
- data:
default: true
examples:
default:
value:
data:
default: true
required: false
responses:
'200':
description: OK
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/Response.Data'
- properties:
data:
$ref: '#/components/schemas/Response.Currency'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Response.Error'
example:
errors:
- status: 400
title: Bad Request
detail: The request was invalid
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Response.Error'
example:
errors:
- status: 401
title: Unauthorized
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/Response.Error'
example:
errors:
- status: 404
title: Currency not found
detail: The requested currency could not be found
deprecated: false
delete:
tags:
- Currencies
summary: Delete a Currency
description: 'Delete a currency.
:::caution
- You can’t delete a default currency.
:::'
operationId: deleteACurrency
parameters:
- name: currencyID
in: path
description: The ID for the Currency to delete.
required: true
style: simple
schema:
type: string
responses:
'204':
description: No Content
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Response.Error'
example:
errors:
- status: 400
title: Bad Request
detail: The request was invalid
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/Response.Error'
example:
errors:
- status: 404
title: Currency not found
detail: The requested currency could not be found
deprecated: false
components:
schemas:
Response.Data:
type: object
properties:
data: {}
SelfLink:
type: object
properties:
self:
description: Specifies the URL of this currency.
type: string
Data.CreateCurrencies:
required:
- type
- code
- exchange_rate
- format
- decimal_point
- thousand_separator
- decimal_places
- default
- enabled
type: object
properties:
code:
description: Specifies the currency code. Example YEN.
type: string
example: GBP
maxLength: 3
minLength: 3
decimal_places:
description: Indicates how many decimal places the currency is formatted to.
type: number
example: 2
minimum: 0
decimal_point:
description: Indicates the decimal point character.
type: string
example: .
default:
description: Specifies whether this is the default currency or not. Either `true` or `false`.
type: boolean
example: true
enabled:
description: Specifies if this currency is available for products. Either `true` or `false`.
type: boolean
example: true
exchange_rate:
description: Specifies the exchange rate from the default currency.
type: number
example: 1
minimum: 0
format:
description: Specifies how the price currency is displayed. For example, "¥{price}".
type: string
example: £{price}
thousand_separator:
description: Indicates the thousand separator character.
type: string
example: ','
type:
description: Represents the type represents the object being returned.
type: string
example: currency
Response.Error:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: string
description: An application-specific error code.
example: '1'
detail:
type: string
status:
type: integer
example: 400
title:
type: string
Response.Meta.Currency:
type: object
properties:
timestamps:
$ref: '#/components/schemas/Timestamps'
owner:
description: Indicates whether the owner is store or org.
example: store
type: string
Data.UpdateCurrencies:
title: Data.UpdateCurrencies
type: object
properties:
default:
description: Specifies whether this is the default currency or not. Either `true` or `false`.
type: boolean
example: true
Request.CreateCurrencies:
title: Request.CreateCurrencies
type: object
properties:
data:
$ref: '#/components/schemas/Data.CreateCurrencies'
Timestamps:
type: object
properties:
created_at:
description: Indicates the creation date of this currency.
type: string
example: '2023-11-07T23:04:18.845Z'
updated_at:
description: Indicates the updated date of this currency.
example: '2023-11-07T23:04:18.845Z'
Response.Currency:
type: object
properties:
id:
description: The unique identifier for this currency.
example: 0c45e4ec-26e0-4043-86e4-c15b9cf985a0
type: string
type:
description: Represents the type represents the object being returned.
example: currency
type: string
code:
description: Specifies the currency code. For example, YEN.
example: GBP
type: string
exchange_rate:
description: Specifies the exchange rate from the default currency.
example: 1
type: number
format:
description: Specifies how the price currency is displayed. For example, "£{price}".
example: £{price}
type: string
decimal_point:
description: Indicates the decimal point character.
example: .
type: string
thousand_separator:
description: Indicates the thousand separator character.
example: ','
type: string
decimal_places:
description: Indicates how many decimal places the currency is formatted to.
example: 2
type: number
default:
description: Specifies whether this is the default currency or not. Either `true` or `false`.
example: true
type: boolean
enabled:
description: Specifies if this currency is available for products. Either `true` or `false`.
example: true
type: boolean
links:
$ref: '#/components/schemas/SelfLink'
meta:
$ref: '#/components/schemas/Response.Meta.Currency'
Request.UpdateCurrencies:
type: object
properties:
data:
$ref: '#/components/schemas/Data.UpdateCurrencies'
securitySchemes:
bearerAuth:
type: http
scheme: bearer