Skip to content

Gateway terms of use status

GET
/domains/{domain}/gateways/terms
curl --request GET \
--url https://api.nsin.ir/domains/example.com/gateways/terms \
--header 'Authorization: Bearer <token>'

Whether this domain has accepted the gateway terms of use, and who accepted them. Gateways route traffic over shared egress IP addresses that can change, so the terms must be accepted before a gateway can be enabled — POST .../apply returns 403 with error_code: gateway_terms_required until they are.

Acceptance is per DOMAIN, not per user.

domain
required
string

The domain name (for example example.com) — not a numeric id.

Example
example.com

Terms status

Media type application/json

Per-domain acceptance of the gateway terms of use. accepted is false until someone with records-edit permission accepts them.

object
accepted
boolean
accepted_at
string format: date-time
accepted_by_id
integer
accepted_by_name
string
accepted_by_email
string
version

Revision of the terms that was accepted.

integer
Example generated
{
"accepted": true,
"accepted_at": "2026-04-15T12:00:00Z",
"accepted_by_id": 1,
"accepted_by_name": "example",
"accepted_by_email": "example",
"version": 1
}

Missing, malformed, revoked or expired API key — or the owning account is inactive.

Media type application/json

The single error shape used by every endpoint.

object
error
required

Human-readable description of what went wrong.

string
Examples
Example invalidKey
{
"error": "invalid API key"
}

No such domain, or it is not visible to this account. Domains you cannot access are reported as not found rather than forbidden.

Media type application/json

The single error shape used by every endpoint.

object
error
required

Human-readable description of what went wrong.

string
Example
{
"error": "read-only API key"
}