Skip to main content
GET
Detailed agency record

Authorizations

Authorization
string
header
default:sk_test_DEMO0000_replace_with_your_sandbox_key
required

API key authentication. Issued by the Safariat admin or via the partner portal. The secret is shown only once at generation.

Production sk_live_* keys must additionally sign every write request (POST/PUT/DELETE) with the X-Timestamp and X-Signature headers. Sandbox sk_test_* keys are exempt from request signing: X-Signature and X-Timestamp are not required for writes in the sandbox (so the developer-portal "Try it" playground works end to end). The Idempotency-Key header remains required on writes in both environments.

Path Parameters

id
string<uuid>
required

Agency identifier.

Response

Agency found

Public profile of a Safariat partner — either an AGENCY (legal entity) or a GUIDE (independent guide). Internal compliance fields (VAT, ICE, CIN, license numbers, postal address, commercial terms) are intentionally omitted from this representation.

id
string<uuid>
required
slug
string
required

Stable URL-friendly identifier.

Example:

"sahara-demo-trekking"

name
string
required
Example:

"Sahara Demo Trekking"

type
enum<string>
required

AGENCY = legal entity, GUIDE = independent licensed guide.

Available options:
AGENCY,
GUIDE
rating
object
required
total_adventures
integer
required

Number of active adventures currently published by this partner.

Required range: x >= 0
description
string | null

Short public bio (~ one paragraph).

long_description
string | null

Full public bio (markdown-free plain text).

logo_url
string<uri> | null
cover_image_url
string<uri> | null
location
string | null

Human-readable location label (e.g. "Marrakech, Morocco").

city
string | null
country
string | null

Defaults to "Maroc" when unset.

founded_year
integer | null
Required range: x >= 1900
team_size
integer | null
Required range: x >= 0
languages
string[]

ISO-639-1 language codes the partner team speaks (e.g. fr, en, ar, es).

specialties
string[]
certifications
string[]
badges
object[]
contact_email
string<email> | null
contact_phone
string | null
website
string<uri> | null

Only present when at least one network is set. Null/missing fields = no link.