Get the organization and the caller
const url = 'https://api.connectato.com/v1/organization';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://api.connectato.com/v1/organization \ --header 'Authorization: Bearer <token>'Scope: none (any valid access token).
The organization the app’s installation belongs to, and what the
caller was granted. Needs no scope: any valid token may ask, so a client checks its credentials and scopes with it. A store app
reads its store there too (caller.store): whether it takes orders now
and the import cut-off day.
Authorizations
Section titled "Authorizations"Responses
Section titled "Responses"OrganizationResource
object
The organization’s public id (org_...), as webhooks name it.
The IANA zone its business days are counted in (Europe/Bucharest).
object
The scopes the call may use.
The app’s OAuth client id (its Client ID).
The store this app is in the organization (an app installed as one of its stores); null for any other caller.
object
The store integration (int_...); every order the app sends names it as its integration_id.
connected (orders are taken in); paused (by the merchant) or disabled (on hold: the app suspended, a permission missing): every order sent is refused with integration_paused until it is connected again.
Orders placed before this day (the organization’s midnight) are not imported (refused, reason before_cutoff); null takes every order. Until the merchant sets one, the day the store was connected.
Example generated
{ "id": "example", "name": "example", "timezone": "example", "caller": { "scopes": [ "example" ], "app_id": "example", "store": { "integration_id": "example", "status": "example", "import_cutoff_date": "2026-04-15" } }}Headers
Section titled "Headers"Requests allowed per minute (per caller; before authentication, failed attempts per address).
Requests left in the current minute.
No valid access token.
object
The documentation URL of the code.
A short summary of the error, in English.
The HTTP status, repeated.
The stable code: one of bad_request, unauthenticated, insufficient_scope, forbidden, not_found, method_not_allowed, payload_too_large, validation_failed, idempotency_key_required, idempotency_key_invalid, idempotency_key_reused, idempotency_in_progress, conflict, rate_limited, server_error, unavailable, or the code an endpoint declares for a refused action.
The explanation for this case, in English.
Validation only: the messages per field.
object
Example generated
{ "type": "https://example.com", "title": "example", "status": 1, "code": "example", "detail": "example", "errors": { "additionalProperty": [ "example" ] }}Headers
Section titled "Headers"Requests allowed per minute (per caller; before authentication, failed attempts per address).
Requests left in the current minute.
Bearer: send an access token as a Bearer token.
Too many requests: retry after Retry-After seconds.
object
The documentation URL of the code.
A short summary of the error, in English.
The HTTP status, repeated.
The stable code: one of bad_request, unauthenticated, insufficient_scope, forbidden, not_found, method_not_allowed, payload_too_large, validation_failed, idempotency_key_required, idempotency_key_invalid, idempotency_key_reused, idempotency_in_progress, conflict, rate_limited, server_error, unavailable, or the code an endpoint declares for a refused action.
The explanation for this case, in English.
Validation only: the messages per field.
object
Example generated
{ "type": "https://example.com", "title": "example", "status": 1, "code": "example", "detail": "example", "errors": { "additionalProperty": [ "example" ] }}Headers
Section titled "Headers"Requests allowed per minute (per caller; before authentication, failed attempts per address).
Requests left in the current minute.
Seconds to wait before retrying.