Skip to main content
ZAD Tour and Travel Agent

Developers

Partner API

Versioned JSON at /api/v1 with scoped credentials, idempotency keys, and signed webhooks.

API health Request credentials

Portal

Integrate with Zad operations.

Green-branded developer surface for partners who need system-to-system booking coordination.

Start

Getting started

Request client credentials from Zad. Secrets are shown once and stored hashed.

Spec

OpenAPI

Specification expands with each release — partner-facing contracts stay versioned.

Status

Health

Use /api/v1/health and the public organization profile endpoint.

Explore

Security

Scoped access

Least-privilege credentials per partner integration with webhook signatures.

Reference

Endpoints

Method Path Auth Returns
GET /api/v1/health Public Service status and server time.
GET /api/v1/organization Public Contact channels, office address, opening hours and services.
GET /api/v1/packages Public Paginated published packages with per-locale translations.
POST /api/v1/quotes Bearer token Creates a quote request and returns its reference.

Example request

curl https://zadtravelagency.com/api/v1/organization

Example response

{
  "data": {
    "name": "ZAD Tour and Travel Agent",
    "contact": {
      "phones": ["+251 986 111 333"],
      "office": { "city": "Addis Ababa", "country": "Ethiopia" }
    },
    "services": ["umrah", "group_umrah", "family_umrah"]
  }
}

Authenticated call

curl -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Idempotency-Key: $(uuidgen)" \
     https://zadtravelagency.com/api/v1/quotes
Partner review

Need credentials?

Contact the Zad office to request scoped partner access. Production keys are issued only after review.

Contact for API access

Scoped credentials

Least-privilege access per partner integration.

Idempotency keys

Safe retries for booking and payment workflows.

Signed webhooks

Event delivery with verification for partners.

Begin with Zad

Build on a trustworthy Umrah platform

Institutional partners can request API access after operational review.

Request access Company facts

Language