Huuray Catalogue API
The Catalogue API from Huuray — 1 operation(s) for catalogue.
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-catalogue-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 Catalogue 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: Catalogue
paths:
/v4/Catalogue:
post:
tags:
- Catalogue
summary: Used to get a list of the available products
description: The list will include both texts and images. It will also include your currently available discount if "All" is set to "False"
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/CatalogueRequest'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/CatalogueResponse'
'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'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/Response'
security:
- ApiToken: []
components:
schemas:
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
CatalogueProduct:
title: Product (Catalogue)
type: object
properties:
ProductToken:
type:
- string
- 'null'
description: Unique product ID<br />Only part of the response if the 'all' request-parameter is 'false'
BrandName:
type:
- string
- 'null'
description: Products brand name
Country:
type:
- string
- 'null'
description: Country name
CountryCode:
type:
- string
- 'null'
description: Country IsoAlpha2 code
Discount:
type:
- number
- 'null'
description: Discount in percent
format: decimal(5,2)
Denominations:
type:
- string
- 'null'
description: Product denominations separated by commas
Currency:
type:
- string
- 'null'
description: Currency IsoAlpha3 code
RealTimeStock:
type:
- string
- 'null'
description: Real-time or Stock
Categories:
type:
- string
- 'null'
description: Product categories separated by commas
LanguageCode:
type:
- string
- 'null'
description: Language IsoAlpha2 code
Active:
type: boolean
description: Active status
BrandDescription:
type:
- string
- 'null'
description: Brand description in original language
RedemptionInstructions:
type:
- string
- 'null'
description: Redemption instructions in original language
LogoFile:
type:
- string
- 'null'
description: Logo file url
additionalProperties: false
description: An object containing information about product
CatalogueResponse:
title: Product Catalogue Response
type: object
properties:
Products:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/CatalogueProduct'
description: The list of products
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 containing products
CatalogueRequest:
title: Product Catalogue Request
type: object
properties:
All:
type:
- boolean
- 'null'
description: Set this option to 'true' to fetch the entire product catalog; 'false' to limit the search to the products that your account has access to
additionalProperties: false
description: An object containing the required input for the product catalogue API
securitySchemes:
ApiToken:
type: apiKey
description: The API-Token provided to you by Huuray.
name: X-API-TOKEN
in: header