curl --request GET \
--url https://api.gigstack.io/v2/teams/{id}/integrations/netsuite/invoices/{invoiceId}/sync \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.gigstack.io/v2/teams/{id}/integrations/netsuite/invoices/{invoiceId}/sync', 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}/integrations/netsuite/invoices/{invoiceId}/sync"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"success": true,
"timestamp": 123,
"data": {
"provider": "netsuite",
"operation": "sync_status",
"livemode": true,
"effect_scope": "team_shared",
"data": {
"exists": true,
"id": "<string>",
"invoiceId": "<string>",
"status": "<string>",
"attempts": "<string>",
"environment": "<string>",
"shadow": "<string>",
"skipReason": "<string>",
"updatedAt": 123,
"syncedAt": 123,
"lastError": {
"step": "<string>",
"permanent": "<string>",
"at": 123,
"message_redacted": true
},
"steps": {
"record": {
"netsuiteId": "<string>",
"recordType": "<string>"
},
"payment": {
"netsuitePaymentId": "<string>"
},
"files": {
"pdfAttached": "<string>",
"xmlAttached": "<string>"
}
},
"attention": {
"code": "<string>",
"at": 123
},
"diagnosis": {
"code": "<string>",
"actor": "<string>",
"severity": "<string>",
"title": "<string>",
"detail": "<string>",
"actions": [
"<string>"
],
"context": {
"description": "<string>",
"tercero": "<string>",
"relatedInvoiceId": "<string>"
}
}
}
}
}netsuite sync status
Requires a verified Firebase or active signed personal MCP user. Team API keys/OAuth cannot impersonate their creator. Current role, credential mode and target team are rechecked by the provider service; blocked users are refused. Response data carries provider, operation, livemode, effect_scope and the safe provider result.
Safe allowlisted sync state. Raw upstream errors are redacted; diagnosis retains selected actionable fields. Missing sync returns 404.
curl --request GET \
--url https://api.gigstack.io/v2/teams/{id}/integrations/netsuite/invoices/{invoiceId}/sync \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.gigstack.io/v2/teams/{id}/integrations/netsuite/invoices/{invoiceId}/sync', 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}/integrations/netsuite/invoices/{invoiceId}/sync"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"success": true,
"timestamp": 123,
"data": {
"provider": "netsuite",
"operation": "sync_status",
"livemode": true,
"effect_scope": "team_shared",
"data": {
"exists": true,
"id": "<string>",
"invoiceId": "<string>",
"status": "<string>",
"attempts": "<string>",
"environment": "<string>",
"shadow": "<string>",
"skipReason": "<string>",
"updatedAt": 123,
"syncedAt": 123,
"lastError": {
"step": "<string>",
"permanent": "<string>",
"at": 123,
"message_redacted": true
},
"steps": {
"record": {
"netsuiteId": "<string>",
"recordType": "<string>"
},
"payment": {
"netsuitePaymentId": "<string>"
},
"files": {
"pdfAttached": "<string>",
"xmlAttached": "<string>"
}
},
"attention": {
"code": "<string>",
"at": 123
},
"diagnosis": {
"code": "<string>",
"actor": "<string>",
"severity": "<string>",
"title": "<string>",
"detail": "<string>",
"actions": [
"<string>"
],
"context": {
"description": "<string>",
"tercero": "<string>",
"relatedInvoiceId": "<string>"
}
}
}
}
}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.