curl --request GET \
--url https://api.gigstack.io/v2/teams/{id}/billing/prices \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.gigstack.io/v2/teams/{id}/billing/prices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.gigstack.io/v2/teams/{id}/billing/prices"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"success": true,
"data": {
"country": "MEX",
"currency": "MXN",
"taxes_included": false,
"available": true,
"units": {
"invoice_income": {
"label": "Factura de ingreso",
"charged": true,
"listed": true,
"free_units": 10,
"tiers": [
{
"up_to": 50,
"unit_price": 2.1
},
{
"up_to": null,
"unit_price": 0.4
}
],
"automatic_multiplier": 0.5
}
},
"features": {
"recurring_invoicing": {
"label": "Facturas y pagos recurrentes",
"charged": true,
"listed": true,
"scope": "team",
"monthly_price": 99,
"included": false,
"add_on": true,
"per_account_with_connect": true,
"charge_only_when_active": false
}
},
"signup_credits": null,
"billing_threshold": 500,
"billing_threshold_source": "catalog"
},
"timestamp": 123
}Read Pricing v3 prices
What each add-on, monthly fee and document costs, from the billing catalog, in MXN before IVA. The public GET /pricing list for Mexico, where gigstack bills every account, plus the items not listed there, so an account offered an add-on not on the public page sees its price. Read-only and cached up to a minute; any team credential may read it. Nothing account-specific: the account’s own early-billing threshold is in the summary’s credits.
curl --request GET \
--url https://api.gigstack.io/v2/teams/{id}/billing/prices \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.gigstack.io/v2/teams/{id}/billing/prices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.gigstack.io/v2/teams/{id}/billing/prices"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"success": true,
"data": {
"country": "MEX",
"currency": "MXN",
"taxes_included": false,
"available": true,
"units": {
"invoice_income": {
"label": "Factura de ingreso",
"charged": true,
"listed": true,
"free_units": 10,
"tiers": [
{
"up_to": 50,
"unit_price": 2.1
},
{
"up_to": null,
"unit_price": 0.4
}
],
"automatic_multiplier": 0.5
}
},
"features": {
"recurring_invoicing": {
"label": "Facturas y pagos recurrentes",
"charged": true,
"listed": true,
"scope": "team",
"monthly_price": 99,
"included": false,
"add_on": true,
"per_account_with_connect": true,
"charge_only_when_active": false
}
},
"signup_credits": null,
"billing_threshold": 500,
"billing_threshold_source": "catalog"
},
"timestamp": 123
}Authorizations
Authentication Method: HTTP Bearer token.
The runtime requires the literal Bearer prefix — a bare token in the
Authorization header is rejected with 401 unauthorized.
Header Format: Authorization: Bearer YOUR_API_KEY
Your API key is a JWT. Live keys operate on live data (livemode: true);
test keys operate on isolated test data (livemode: false).
Get your key at: app.gigstack.pro/settings?tab=api
Errors: credential failures are answered by the authentication layer with a raw
{ "message": … } body, not the standardized envelope — 401 for a missing, malformed or
expired token, 403 for a revoked key or a plan without API access. See the Unauthorized
and AuthForbidden responses.
Path Parameters
Response
The price list.
true Pricing v3 price list, from the billing catalog (the admin panel edits it). Amounts are MXN before IVA (16% is added on top): catalog credits × the country's credit value. A price the catalog does not have is left out, never guessed, so hide what is missing instead of showing a remembered number. One rule for charged: false means free, and the item is listed at 0 (monthly_price and every unit_price). An add-on (add_on: true) with charged: false is turned on at no cost. The only exception is the first RFC while it is a fixed item of the subscription: its monthly_price stays, since going live charges it. listed says whether the item is on the public list; GET /pricing leaves out the ones that are not, the account's own list keeps them.
Show child attributes
Show child attributes
{
"country": "MEX",
"currency": "MXN",
"taxes_included": false,
"available": true,
"units": {
"invoice_income": {
"label": "Factura de ingreso",
"charged": true,
"listed": true,
"free_units": 10,
"tiers": [
{ "up_to": 50, "unit_price": 2.1 },
{ "up_to": null, "unit_price": 0.4 }
],
"automatic_multiplier": 0.5
}
},
"features": {
"recurring_invoicing": {
"label": "Facturas y pagos recurrentes",
"charged": true,
"listed": true,
"scope": "team",
"monthly_price": 99,
"included": false,
"add_on": true,
"per_account_with_connect": true,
"charge_only_when_active": false
}
},
"signup_credits": null,
"billing_threshold": 500,
"billing_threshold_source": "catalog"
}