Member Validation API Documentation v2.0.5
GET /agency-validate

Full Agency Validation — Validates membership status for a travel agency.

This is the dedicated alternative to GET /validate?membertype=agency and does not require a membertype parameter.

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

Parameters

ParameterRequiredDescriptionValidation Rules
agencyIndustryID Required The agency's industry ID Exactly 8 digits, numbers only

Response Fields

FieldTypeDescription
SuccessBooleanIndicates whether the request was processed successfully
ResponseCodeIntegerMembership validity status: 0 = no valid record, 1 = expired or non-member, 2 = fully valid
MessageStringA human-readable description of the validation result
MembershipTypeStringAgency when a Travel-Trade member record is found (valid or expired); Non-Member when the record is not a Travel-Trade member or no record is found. See Response Conventions.
NameStringAgency name
CLIA_CompanyIDStringCLIA's internal company ID
IndustryIDStringAgency's industry ID (mirrors the value sent in the request)
CityStringAgency's city (member responses only)
StateStringAgency's state (member responses only)
ZipCodeStringAgency's postal code (member responses only)
DuesPaidThruString or nullDate through which dues are paid (YYYY-MM-DD). null when the record has no dues date — treated as expired. Member responses only.
MemberTypeIDStringInternal CLIA member type identifier. Contact CLIA if your integration needs a key to these values. Member responses only.
Non-Member Responses
When the record is not a Travel-Trade member, the response includes only Name, CLIA_CompanyID, and IndustryID in addition to the common fields. Address and dues fields are not included.

Response Codes

CodeDescription
0No valid record found
1Record found but with limitations (expired dues, missing dues date, or not a Travel-Trade member)
2Valid, active membership

Example Request and Responses

Request

HTTP Request
GET /agency-validate?agencyIndustryID=12345678
Headers:
  x-api-key: your-api-key

Valid Membership

200 OK — ResponseCode 2
{
  "Success": true,
  "ResponseCode": 2,
  "Message": "Valid membership",
  "MembershipType": "Agency",
  "Name": "Global Travel Agency",
  "CLIA_CompanyID": "98765",
  "IndustryID": "12345678",
  "City": "Miami",
  "State": "FL",
  "ZipCode": "33101",
  "DuesPaidThru": "2026-12-31",
  "MemberTypeID": "17"
}

Expired Dues

200 OK — ResponseCode 1
{
  "Success": true,
  "ResponseCode": 1,
  "Message": "Dues are expired",
  "MembershipType": "Agency",
  "Name": "Global Travel Agency",
  "CLIA_CompanyID": "98765",
  "IndustryID": "12345678",
  "City": "Miami",
  "State": "FL",
  "ZipCode": "33101",
  "DuesPaidThru": "2024-12-31",
  "MemberTypeID": "53"
}

Expired — No Dues Date on Record

A Travel-Trade member with no dues date on record (for example, an imported record) is treated as expired and DuesPaidThru is null.

200 OK — ResponseCode 1
{
  "Success": true,
  "ResponseCode": 1,
  "Message": "Dues are expired",
  "MembershipType": "Agency",
  "Name": "Global Travel Agency",
  "CLIA_CompanyID": "98765",
  "IndustryID": "12345678",
  "City": "Miami",
  "State": "FL",
  "ZipCode": "33101",
  "DuesPaidThru": null,
  "MemberTypeID": "17"
}

Not a Travel-Trade Member

200 OK — ResponseCode 1
{
  "Success": true,
  "ResponseCode": 1,
  "Message": "Agency/Company is not a Travel-Trade Member",
  "MembershipType": "Non-Member",
  "Name": "Global Travel Agency",
  "CLIA_CompanyID": "98765",
  "IndustryID": "12345678"
}

Error Responses

Authentication Error

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

Missing or Invalid Parameters

400 Bad Request
{
  "Success": false,
  "Message": "agencyIndustryID is required for agency validation."
}
400 Bad Request
{
  "Success": false,
  "Message": "agencyIndustryID must be exactly 8 digits and contain only numbers."
}

Not Found

404 Not Found
{
  "Success": false,
  "ResponseCode": 0,
  "Message": "No valid record found.",
  "MembershipType": "Non-Member"
}

Quota Limit Reached

429 Too Many Requests
{
  "Success": false,
  "Message": "Quota limit reached"
}

Server Error

Error details are captured in CLIA's server-side logs and are not exposed in the response.

500 Internal Server Error
{
  "Success": false,
  "Message": "An error occurred while processing the request.",
  "MembershipType": "Agency"
}

Notes