AgentPings.com

API Documentation

/api/agent-status-price Endpoint

Detailed documentation for the `/api/agent-status-price` endpoint.

Endpoint:

URL:https://agentpings.com/api/agent-status-price

Methods: GET, POST

Description:

This endpoint checks if an agent is available for a given phone number's area code and vertical. It also returns the price associated with the vertical.

Parameters:

  • phone: (Optional) Phone number. Cannot be provided if state or zip is already provided.
  • zip: (Optional) ZIP code. Cannot be provided if phone or state is already provided.
  • state: (Optional) State code (2 characters) or full state name. Cannot be provided if phone or zip is already provided.
  • vertical: (Required) Vertical. Valid values: auto_insurance, final_expense, u65_health, aca, medicare.
  • affiliate_id: (Required) Identifier for the affiliate.
  • api_key: (Required) API key associated with the affiliate.

Note: One of phone, zip, or state is required for the request.

Response:

200 OK

{
    "online": true,
    "price": 25
}
            

online: true if the agent is available, false otherwise.

price: Price associated with the provided vertical.

Examples:

Request:

GET https://agentpings.com/api/agent-status-price?phone=1234567890&vertical=auto_insurance&affiliate_id=YOUR_AFFILIATE_ID&api_key=YOUR_API_KEY

Response:

{
    "online": true,
    "price": 25
}
                

Notes:

  • This API checks the availability of an agent based on the provided parameters and fetches the associated price.
  • Affiliates using the API must provide valid credentials for authentication.