Skip to content

Get the organization and the caller

GET
/organization
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.

OrganizationResource

Media typeapplication/json
OrganizationResource
object
id
required

The organization’s public id (org_...), as webhooks name it.

string
/^org_[0-9a-z]{26}$/
name
required
string
timezone
required

The IANA zone its business days are counted in (Europe/Bucharest).

string
caller
required
object
scopes
required

The scopes the call may use.

Array<string>
app_id
required

The app’s OAuth client id (its Client ID).

string
store
required

The store this app is in the organization (an app installed as one of its stores); null for any other caller.

object
integration_id
required

The store integration (int_...); every order the app sends names it as its integration_id.

string
/^int_[0-9a-z]{26}$/
status
required

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.

string
import_cutoff_date
required

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.

string | null format: date

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"
}
}
}
X-RateLimit-Limit
integer

Requests allowed per minute (per caller; before authentication, failed attempts per address).

X-RateLimit-Remaining
integer

Requests left in the current minute.

No valid access token.

Media typeapplication/problem+json
Problem
object
type
required

The documentation URL of the code.

string format: uri
title
required

A short summary of the error, in English.

string
status
required

The HTTP status, repeated.

integer
code
required

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.

string
detail

The explanation for this case, in English.

string
errors

Validation only: the messages per field.

object
key
additional properties
Array<string>

Example generated

{
"type": "https://example.com",
"title": "example",
"status": 1,
"code": "example",
"detail": "example",
"errors": {
"additionalProperty": [
"example"
]
}
}
X-RateLimit-Limit
integer

Requests allowed per minute (per caller; before authentication, failed attempts per address).

X-RateLimit-Remaining
integer

Requests left in the current minute.

WWW-Authenticate
string

Bearer: send an access token as a Bearer token.

Too many requests: retry after Retry-After seconds.

Media typeapplication/problem+json
Problem
object
type
required

The documentation URL of the code.

string format: uri
title
required

A short summary of the error, in English.

string
status
required

The HTTP status, repeated.

integer
code
required

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.

string
detail

The explanation for this case, in English.

string
errors

Validation only: the messages per field.

object
key
additional properties
Array<string>

Example generated

{
"type": "https://example.com",
"title": "example",
"status": 1,
"code": "example",
"detail": "example",
"errors": {
"additionalProperty": [
"example"
]
}
}
X-RateLimit-Limit
integer

Requests allowed per minute (per caller; before authentication, failed attempts per address).

X-RateLimit-Remaining
integer

Requests left in the current minute.

Retry-After
integer

Seconds to wait before retrying.