curl --request GET \
--url https://api.gigstack.io/v2/catalogs/product-keys \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.gigstack.io/v2/catalogs/product-keys', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.gigstack.io/v2/catalogs/product-keys"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"message": "Product keys searched successfully",
"data": [
{
"code": "84111506",
"description": "Servicios de facturación"
}
],
"found": 1,
"page": 1,
"per_page": 10,
"success": true,
"timestamp": 1767225600000
}Search SAT product keys
Full-text search over the SAT c_ClaveProdServ catalog, the same catalog the dashboard
searches when you pick a default product key. Returns the codes you assign to an item’s
product_key.
Search Capabilities:
- Matches on code, description and SAT taxonomy (type, division, group)
- Typo-tolerant fuzzy matching, ranked by relevance
- Paginated results
Notes:
- The catalog is published by the SAT and is identical for every team, so results are not
affected by
livemodeand contain no team data. Authentication is still required. - Typesense must be configured for your team.
- The
q(orquery) parameter is required.
curl --request GET \
--url https://api.gigstack.io/v2/catalogs/product-keys \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.gigstack.io/v2/catalogs/product-keys', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.gigstack.io/v2/catalogs/product-keys"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"message": "Product keys searched successfully",
"data": [
{
"code": "84111506",
"description": "Servicios de facturación"
}
],
"found": 1,
"page": 1,
"per_page": 10,
"success": true,
"timestamp": 1767225600000
}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.
Query Parameters
gigstack Connect: Target team ID for multi-team access.
Requires gigstack Connect enabled on your team and shared billing account.
Also requires the multipleIssuerAccounts feature on your plan. Requests targeting a
team other than the one your API key belongs to return 403 without it.
Only API keys can use it: an OAuth access token sent with another team's id is rejected with
403 Team mismatch with OAuth token.
Optional — omit it entirely unless you are acting on another team. It deliberately
carries no example value so generated snippets do not emit ?team=undefined; when the
parameter is absent, the team is derived from your API key.
Example: ?team=team_xyz789
Search query text (primary parameter). Searches across relevant fields depending on the collection
(e.g., client name, email, payment ID, description, metadata). The query parameter is also accepted
as a backward-compatible alternative.
Alternative to q, kept for backward compatibility. If both are provided, q takes precedence.
Maximum number of items to return (default 10, max 100)
1 <= x <= 100Page number for pagination (default 1)
x >= 1Comma-separated list of fields to include in the response
Response
Product keys searched successfully
"Product keys searched successfully"
Show child attributes
Show child attributes
Total number of results found
15
Current page number
1
Number of results per page
10
true
1704067200000