GET /simple-agent-validate

Simplified Agent Validation — Returns a single integer result code for lightweight membership checks.

Validates travel agent membership using a personal ID only, returning a single integer result code. This endpoint is optimized for high-volume integrations where a minimal response payload is preferred over the full membership detail returned by GET /agent-validate.

Always HTTP 200

This endpoint returns HTTP 200 for all processed requests — the outcome is communicated entirely through the Result code. A 401 is still returned for an invalid or missing API key.

Base URL https://api-membervalidation.cruising.org

Parameters

Parameter	Required	Description	Validation Rules
`personalID`	Required	The agent's personal ID	Max 10 digits, numbers only
`debug`	Optional	Set to `true` to include debug details in the response	—

Debug Mode

Debug mode is intended for troubleshooting only and should not be enabled in production environments.

Response Fields

Field	Type	Description
`Result`	Integer	Membership validity status code (see table below)
`Debug`	String	Debug details; only included when `debug=true` is passed in the request

Result Codes

Code	Description
`0`	Invalid personalID format or empty value
`1`	Valid current Travel-Trade member
`2`	Expired Travel-Trade member (expired or missing dues date)
`3`	Record found but a different member type (not a current Travel-Trade member)
`5`	No record found in the database
`9`	Database connection or query error

Result Code 4

Result code 4 is retired and no longer returned. A Travel-Trade member without a dues date on record now returns 2 (treated as expired).

Example Requests and Responses

Request

HTTP Request

GET /simple-agent-validate?personalID=00002595
Headers:
  x-api-key: your-api-key

Valid Current Member

200 OK

{
  "Result": 1
}

Other Possible Results

200 OK — Various Result Codes

{ "Result": 2 }  // Expired member (expired or missing dues date)
{ "Result": 3 }  // Different member type (not Travel-Trade)
{ "Result": 5 }  // No record found
{ "Result": 0 }  // Invalid personalID format
{ "Result": 9 }  // Database error

Request with Debug Mode

HTTP Request

GET /simple-agent-validate?personalID=00002595&debug=true
Headers:
  x-api-key: your-api-key

Valid Current Member with Debug

200 OK — Debug Enabled

{
  "Result": 1,
  "Debug": "Processing PersonalID: 00002595 | Database connection successful | Record found - MemberTypeID: 5, DuesPaidThru: 2026-12-31 | Current Travel-Trade member"
}

Expired Member — No Dues Date, with Debug

200 OK — Debug Enabled

{
  "Result": 2,
  "Debug": "Processing PersonalID: 00002595 | Database connection successful | Record found - MemberTypeID: 5, DuesPaidThru: NULL | Travel-Trade member with no dues date - treated as expired"
}

Error Responses

Authentication Error

401 Unauthorized

{
  "Success": false,
  "Message": "Invalid or missing API Key"
}

Invalid Parameter

Format problems do not produce an HTTP error — the endpoint responds with Result: 0.

200 OK — Result 0

{
  "Result": 0
}

Quota Limit Reached

429 Too Many Requests

{
  "Success": false,
  "Message": "Quota limit reached"
}

Notes

A valid membership requires an active Travel-Trade member record with dues paid through a future date.
A Travel-Trade member with an expired or missing dues date returns Result: 2.
All date fields follow ISO 8601 format (YYYY-MM-DD).