Skip to content
nsin docs

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

Whether this domain has accepted the gateway terms of use.

boolean
accepted_at

When they were accepted.

string format: date-time
accepted_by_id

User id of whoever accepted them.

integer
accepted_by_name

Their name, when known.

string
accepted_by_email

Their email, when known.

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. (A valid key whose account has been deactivated gets 403 account is inactive instead.)

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"
}