Ping

Verifies that your credentials, signature and network work, and returns your quota status. This is the first call to make after receiving your keys.

GET/v1/{code}/ping

Request

No parameters. Authentication headers are required — see Request signing.

Headers

  • Name
    Accept
    Type
    string
    Description

    application/json (default) or application/xml.

GET
/v1/1000/ping
curl -s "https://partners.bravebooking.net/v1/1000/ping" \
  -H "X-Api-Key: $API_KEY" \
  -H "X-Timestamp: $TIMESTAMP" \
  -H "X-Signature: $SIGNATURE" \
  -H "Accept: application/json"

Response

{
  "status": "ok",
  "company": "1000",
  "partner": "demo-partner",
  "mode": "test",
  "time": "2026-11-13T10:15:30+01:00",
  "quota": {
    "perSecond": 10,
    "perDay": 20000,
    "remainingToday": 19982,
    "resetAt": "2026-11-14T00:00:00+01:00"
  }
}

Response fields

  • Name
    status
    Type
    string
    Description

    ok when authentication and key are valid.

  • Name
    mode
    Type
    string
    Description

    test or live depending on the key used.

  • Name
    quota
    Type
    object
    Description

    Key quotas: perSecond, perDay, remainingToday, resetAt. See Rate limits.

Errors

401 (invalid signature, timestamp out of window), 403 (IP not allowed, key revoked, gateway not enabled) — details in Errors.

Was this page helpful?