Huuray Order API
The Order API from Huuray — 1 operation(s) for order.
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/huuray-order-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: Huuray Balance Order API
description: Huuray API for B2B customers (last updated april 2025)
contact:
name: Support
email: tech@huuray.com
version: v4
servers:
- url: https://api.huuray.com
description: Base URL declared by the provider in apis.yml (roadmap#122).
tags:
- name: Order
paths:
/v4/Order:
post:
tags:
- Order
summary: Used to order giftcards
description: The giftcards will be sent out as redeemable links. They will be sent out automatically via Email or SMS, or returned in a callback if you have set one up and enabled this feature
parameters:
- name: X-API-NONCE
in: header
description: A random value that can only be used once every 60 days. (max 50 characters)<br /><small>(this prevents your message from being re-transmitted, and thereby also replay attacks)</small>
required: true
- name: X-API-HASH
in: header
description: 'The SHA512 hash of a concatenated string containing the following: ( API-SECRET + NONCE ).<br /><small>(this is used to authenticate you)</small>'
required: true
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/OrderRequest'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/OrderResponse'
'201':
description: Created
content:
application/json:
schema:
$ref: '#/components/schemas/OrderResponse'
'202':
description: Accepted
content:
application/json:
schema:
$ref: '#/components/schemas/OrderResponse'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Response'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Response'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/Response'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/Response'
'422':
description: Unprocessable Content
content:
application/json:
schema:
$ref: '#/components/schemas/Response'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/Response'
security:
- ApiToken: []
components:
schemas:
OrderRecipient:
title: Recipient (Order)
type: object
properties:
Name:
type:
- string
- 'null'
description: The name of the recipient
Email:
type:
- string
- 'null'
description: The email address of the recipient (required if DeliveryMethod is set to Email)
Phone:
type:
- string
- 'null'
description: The phone number of the recipient (required if DeliveryMethod is set to SMS)
RefID:
type:
- string
- 'null'
description: An optional ID that you can use to identify the individual recipient
additionalProperties: false
description: An object containing information about a single recipient
Response:
type: object
properties:
Status:
type: integer
description: HttpStatus code for the response
format: int32
Message:
type:
- string
- 'null'
description: Deprecated, use StatusMessage instead. Error message describing an error that occurred during the processing of the request
deprecated: true
StatusMessage:
type:
- string
- 'null'
description: Status message describing an error that occurred during the processing of the request
additionalProperties: false
description: The minimal possible response for any request
OrderResponse:
title: Order Response
type: object
properties:
OrderUID:
type:
- string
- 'null'
description: A unique ID which will be connected to the resulting order
RefID:
type:
- string
- 'null'
description: The optional ID that you specified in the order request
Vouchers:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/OrderVoucher'
description: The resulting vouchers for the placed order (contain data only for Sync request)
Status:
type: integer
description: HttpStatus code for the response
format: int32
Message:
type:
- string
- 'null'
description: Deprecated, use StatusMessage instead. Error message describing an error that occurred during the processing of the request
deprecated: true
StatusMessage:
type:
- string
- 'null'
description: Status message describing an error that occurred during the processing of the request
additionalProperties: false
description: The response from the Order request
OrderRequest:
title: Order Request
required:
- Product
- Sync
type: object
properties:
Product:
$ref: '#/components/schemas/OrderProduct'
Sync:
type: boolean
description: Determines whether the Order is a sync order (If set to true, then quantity is limited to 25 and vouchers are returned in the response)
RefID:
type:
- string
- 'null'
description: An optional ID that you can use to identify the resulting order with
DeliveryTemplateId:
type:
- integer
- 'null'
description: The template used to deliver the codes (Email, SMS, or no delivery if null)
format: int32
DeliveryDatetime:
type:
- string
- 'null'
description: An optional future date for delivery to take place, if null delivery will happen as soon as possible
format: date-time
PersonalMessage:
type:
- string
- 'null'
description: An optional message to include in all the SMS/Emails (if applicable)
Recipients:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/OrderRecipient'
description: A list of all the recipients. It is required unless DeliveryTemplateId is null. If specified, the count must be either 1 or match Product.Quantity
additionalProperties: false
description: An object containing all the necessary information for ordering giftcards
OrderVoucher:
title: Voucher (Order)
type: object
properties:
ID:
type:
- integer
- 'null'
description: The unique identifier of the voucher (used by resend and cancel endpoints)
format: int32
Code:
type:
- string
- 'null'
description: The redeemable code of the voucher. (This will be blanked unless ReturnCode is enabled in your B2B Account)
CVV:
type:
- string
- 'null'
description: A value used to verify the authenticity of the voucher (if applicable). (This will be blanked unless ReturnCode is enabled in your B2B Account)
RedeemLink:
type:
- string
- 'null'
description: The URL to redeem the voucher. (This will be blanked unless ReturnCode is enabled in your B2B Account)
Expires:
type: string
description: The time and date for when the voucher expires
format: date-time
Recipient:
$ref: '#/components/schemas/OrderRecipient'
additionalProperties: false
description: An object containing information about a voucher
OrderProduct:
title: Product (Order)
required:
- Currency
- Quantity
- Token
- Value
type: object
properties:
Token:
minLength: 1
type: string
description: The token used to identify a specific product
Value:
type: integer
description: The value denomination that you want to order. Must be specified in minor units (i.e. $5.00 should be sent as 500)
format: int32
Currency:
minLength: 1
type: string
description: The currency of the product
Quantity:
type: integer
description: The amount of codes you are ordering
format: int32
Expires:
type:
- string
- 'null'
description: An optional time and date for the giftcards to expire. If omitted, the default expiration will be used, and the value cannot exceed the default expiration
format: date-time
additionalProperties: false
description: An object containing information about a product
securitySchemes:
ApiToken:
type: apiKey
description: The API-Token provided to you by Huuray.
name: X-API-TOKEN
in: header