Ir al contenido

Get full catalog

GET
/v2/catalog
curl --request GET \
--url https://api.orderfast.com.ar/v2/catalog \
--header 'Authorization: Bearer <token>'

Successful response

Media typeapplication/json
object
data
required
object
location_id
required
string
version
required
string
categories
required
Array<object>
object
id
required
string
name
required
string
external_id
string
products
required
Array<object>
object
id
required
string
external_id
string
sku
required
string
name
required
string
price
required
number
visible
required
boolean
stock
required
object
enabled
required
boolean
quantity
required
number
subselections
required
Array<object>
object
id
required
string
external_id
string
name
required
string
min_selection
required
number
max_selection
required
number
single
required
boolean
items
required
Array<object>
object
id
required
string
external_id
string
name
required
string
price
required
number
min
required
number
max
required
number
visible
required
boolean
image_url
string
stock
required
object
enabled
required
boolean
quantity
required
number
Example
{
"data": {
"location_id": "4f0c8810-6881-4674-96be-880fc32176a7",
"version": "2026-07-07T12:00:00.000Z",
"categories": [
{
"id": "cat_123",
"name": "Hamburguesas",
"external_id": "erp-cat-1",
"products": [
{
"id": "prod_9f03",
"external_id": "erp-product-1001",
"sku": "BURGER-001",
"name": "Hamburguesa Simple",
"price": 8500,
"visible": true,
"stock": {
"enabled": true,
"quantity": 30
},
"subselections": [
{
"id": "sub_123",
"external_id": "erp-extras",
"name": "Extras",
"min_selection": 0,
"max_selection": 3,
"single": false,
"items": [
{
"id": "item_1",
"external_id": "erp-extra-cheese",
"name": "Queso extra",
"price": 500,
"min": 0,
"max": 2,
"visible": true,
"image_url": "https://cdn.orderfast.com.ar/products/cheese.png",
"stock": {
"enabled": true,
"quantity": 30
}
},
{
"id": "item_1",
"external_id": "erp-extra-cheese",
"name": "Queso extra",
"price": 500,
"min": 0,
"max": 2,
"visible": true,
"image_url": "https://cdn.orderfast.com.ar/products/cheese.png",
"stock": {
"enabled": true,
"quantity": 30
}
}
]
},
{
"id": "sub_123",
"external_id": "erp-extras",
"name": "Extras",
"min_selection": 0,
"max_selection": 3,
"single": false,
"items": [
{
"id": "item_1",
"external_id": "erp-extra-cheese",
"name": "Queso extra",
"price": 500,
"min": 0,
"max": 2,
"visible": true,
"image_url": "https://cdn.orderfast.com.ar/products/cheese.png",
"stock": {
"enabled": true,
"quantity": 30
}
},
{
"id": "item_1",
"external_id": "erp-extra-cheese",
"name": "Queso extra",
"price": 500,
"min": 0,
"max": 2,
"visible": true,
"image_url": "https://cdn.orderfast.com.ar/products/cheese.png",
"stock": {
"enabled": true,
"quantity": 30
}
}
]
}
]
},
{
"id": "prod_9f03",
"external_id": "erp-product-1001",
"sku": "BURGER-001",
"name": "Hamburguesa Simple",
"price": 8500,
"visible": true,
"stock": {
"enabled": true,
"quantity": 30
},
"subselections": [
{
"id": "sub_123",
"external_id": "erp-extras",
"name": "Extras",
"min_selection": 0,
"max_selection": 3,
"single": false,
"items": [
{
"id": "item_1",
"external_id": "erp-extra-cheese",
"name": "Queso extra",
"price": 500,
"min": 0,
"max": 2,
"visible": true,
"image_url": "https://cdn.orderfast.com.ar/products/cheese.png",
"stock": {
"enabled": true,
"quantity": 30
}
},
{
"id": "item_1",
"external_id": "erp-extra-cheese",
"name": "Queso extra",
"price": 500,
"min": 0,
"max": 2,
"visible": true,
"image_url": "https://cdn.orderfast.com.ar/products/cheese.png",
"stock": {
"enabled": true,
"quantity": 30
}
}
]
},
{
"id": "sub_123",
"external_id": "erp-extras",
"name": "Extras",
"min_selection": 0,
"max_selection": 3,
"single": false,
"items": [
{
"id": "item_1",
"external_id": "erp-extra-cheese",
"name": "Queso extra",
"price": 500,
"min": 0,
"max": 2,
"visible": true,
"image_url": "https://cdn.orderfast.com.ar/products/cheese.png",
"stock": {
"enabled": true,
"quantity": 30
}
},
{
"id": "item_1",
"external_id": "erp-extra-cheese",
"name": "Queso extra",
"price": 500,
"min": 0,
"max": 2,
"visible": true,
"image_url": "https://cdn.orderfast.com.ar/products/cheese.png",
"stock": {
"enabled": true,
"quantity": 30
}
}
]
}
]
}
]
},
{
"id": "cat_123",
"name": "Hamburguesas",
"external_id": "erp-cat-1",
"products": [
{
"id": "prod_9f03",
"external_id": "erp-product-1001",
"sku": "BURGER-001",
"name": "Hamburguesa Simple",
"price": 8500,
"visible": true,
"stock": {
"enabled": true,
"quantity": 30
},
"subselections": [
{
"id": "sub_123",
"external_id": "erp-extras",
"name": "Extras",
"min_selection": 0,
"max_selection": 3,
"single": false,
"items": [
{
"id": "item_1",
"external_id": "erp-extra-cheese",
"name": "Queso extra",
"price": 500,
"min": 0,
"max": 2,
"visible": true,
"image_url": "https://cdn.orderfast.com.ar/products/cheese.png",
"stock": {
"enabled": true,
"quantity": 30
}
},
{
"id": "item_1",
"external_id": "erp-extra-cheese",
"name": "Queso extra",
"price": 500,
"min": 0,
"max": 2,
"visible": true,
"image_url": "https://cdn.orderfast.com.ar/products/cheese.png",
"stock": {
"enabled": true,
"quantity": 30
}
}
]
},
{
"id": "sub_123",
"external_id": "erp-extras",
"name": "Extras",
"min_selection": 0,
"max_selection": 3,
"single": false,
"items": [
{
"id": "item_1",
"external_id": "erp-extra-cheese",
"name": "Queso extra",
"price": 500,
"min": 0,
"max": 2,
"visible": true,
"image_url": "https://cdn.orderfast.com.ar/products/cheese.png",
"stock": {
"enabled": true,
"quantity": 30
}
},
{
"id": "item_1",
"external_id": "erp-extra-cheese",
"name": "Queso extra",
"price": 500,
"min": 0,
"max": 2,
"visible": true,
"image_url": "https://cdn.orderfast.com.ar/products/cheese.png",
"stock": {
"enabled": true,
"quantity": 30
}
}
]
}
]
},
{
"id": "prod_9f03",
"external_id": "erp-product-1001",
"sku": "BURGER-001",
"name": "Hamburguesa Simple",
"price": 8500,
"visible": true,
"stock": {
"enabled": true,
"quantity": 30
},
"subselections": [
{
"id": "sub_123",
"external_id": "erp-extras",
"name": "Extras",
"min_selection": 0,
"max_selection": 3,
"single": false,
"items": [
{
"id": "item_1",
"external_id": "erp-extra-cheese",
"name": "Queso extra",
"price": 500,
"min": 0,
"max": 2,
"visible": true,
"image_url": "https://cdn.orderfast.com.ar/products/cheese.png",
"stock": {
"enabled": true,
"quantity": 30
}
},
{
"id": "item_1",
"external_id": "erp-extra-cheese",
"name": "Queso extra",
"price": 500,
"min": 0,
"max": 2,
"visible": true,
"image_url": "https://cdn.orderfast.com.ar/products/cheese.png",
"stock": {
"enabled": true,
"quantity": 30
}
}
]
},
{
"id": "sub_123",
"external_id": "erp-extras",
"name": "Extras",
"min_selection": 0,
"max_selection": 3,
"single": false,
"items": [
{
"id": "item_1",
"external_id": "erp-extra-cheese",
"name": "Queso extra",
"price": 500,
"min": 0,
"max": 2,
"visible": true,
"image_url": "https://cdn.orderfast.com.ar/products/cheese.png",
"stock": {
"enabled": true,
"quantity": 30
}
},
{
"id": "item_1",
"external_id": "erp-extra-cheese",
"name": "Queso extra",
"price": 500,
"min": 0,
"max": 2,
"visible": true,
"image_url": "https://cdn.orderfast.com.ar/products/cheese.png",
"stock": {
"enabled": true,
"quantity": 30
}
}
]
}
]
}
]
}
]
}
}

Unauthorized — missing or invalid API key

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: invalid_request unauthorized permission_denied resource_not_found conflict validation_error rate_limited internal_error
message
required
string
request_id
required
string
Examples
Exampleunauthorized

Invalid API key

{
"error": {
"code": "unauthorized",
"message": "Missing or invalid API key",
"request_id": "req_01J..."
}
}

Permission denied

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: invalid_request unauthorized permission_denied resource_not_found conflict validation_error rate_limited internal_error
message
required
string
request_id
required
string
Examples
Examplepermission_denied

Missing permission

{
"error": {
"code": "permission_denied",
"message": "The API key does not have the required permission",
"request_id": "req_01J..."
}
}

Validation error

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: invalid_request unauthorized permission_denied resource_not_found conflict validation_error rate_limited internal_error
message
required
string
request_id
required
string
Examples
Examplevalidation_error

Invalid body or query

{
"error": {
"code": "validation_error",
"message": "One or more fields failed validation",
"request_id": "req_01J..."
}
}

Internal server error

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: invalid_request unauthorized permission_denied resource_not_found conflict validation_error rate_limited internal_error
message
required
string
request_id
required
string
Examples
Exampleinternal_error

Unexpected failure

{
"error": {
"code": "internal_error",
"message": "An unexpected error occurred",
"request_id": "req_01J..."
}
}