Claims Pages API Documentation

Overview

The Claims Pages API provides access to service provider listings, states, counties, categories, and detailed provider profiles. All responses are returned in JSON format.

Base URL

https://www.claimspages.com/api/v1/

Authentication

All API requests require an API key, which should be provided as a query parameter:

?key=YOUR_API_KEY

Example Request:

GET https://www.claimspages.com/api/v1/providers?state=FL&category=0100&key=YOUR_API_KEY

---

Endpoints

Providers

Retrieve a list of service providers based on state, county, and category filters.

GET /providers

Parameters

Parameter	Type	Required	Description
state	string	No	2-letter state abbreviation (e.g., FL, CA, NY). Omit for national search.
county	string	No	County identifier (e.g., FL095).
category	string/int	Yes	Category ID (e.g., 0100) or category name.
key	string	Yes	Your API key.

Response Fields

The API automatically falls back to broader searches if no results are found at the specified level:

• County search → Falls back to state search if no results
• State search → Falls back to adjacent states, then national if no results
• National search → Omit the state parameter to search nationwide

Example Response

{
  "providers": [
    {
      "providerID": "1234",
      "productID": 3,
      "companyName": "ABC Adjusters",
      "locationLine": "123 Main St, Orlando, FL 32801",
      "phone": "555-123-4567",
      "address": "123 Main St",
      "city": "Orlando",
      "state": "FL",
      "zipcode": "32801",
      "webAddress": "http://abcadjusters.com",
      "emailAddress": "contact@abcadjusters.com",
      "vendorDate": "2010-06-15"
    }
  ],
  "totalRecords": 150
}

---

States

GET /states

Retrieve a list of all U.S. states or search by name or abbreviation.

Parameters

Parameter	Type	Required	Description
search	string	No	Search for a state by name or abbreviation.
key	string	Yes	Your API key.

---

Counties

GET /counties

Retrieve a list of counties, filter by state, or search by name.

Parameters

Parameter	Type	Required	Description
search	string	No	Search by county name.
state	string	No	2-letter state abbreviation (e.g., FL, CA, NY).
key	string	Yes	Your API key.

Example Response

{
  "counties": [
    {
      "countyID": "FL095",
      "countyName": "Orange",
      "stateID": 11,
      "stateName": "Florida",
      "stateAbbr": "FL"
    }
  ]
}

---

Categories

GET /categories

Retrieve a list of categories or search by name or keywords.

Parameters

Parameter	Type	Required	Description
search	string	No	Search by category name or keywords.
key	string	Yes	Your API key.

---

Profile

GET /providers/profile

Retrieve detailed provider information using a providerID and phone number.

Parameters

Parameter	Type	Required	Description
providerID	int	Yes	The unique ID of the provider.
phone	string	Yes	The provider's phone number (numeric, no dashes).
key	string	Yes	Your API key.

Example Response

{
  "provider": {
    "providerID": 1234,
    "productID": 3,
    "companyName": "ABC Adjusters",
    "phone": "555-123-4567",
    "address": "123 Main St",
    "city": "Orlando",
    "state": "FL",
    "zipcode": "32801",
    "website": "http://abcadjusters.com",
    "email": "contact@abcadjusters.com"
  }
}

---

Locations (Search)

GET /locations

Search for locations (cities, counties, states, ZIP codes) with a single query. Returns up to 15 results.

Parameters

Parameter	Type	Required	Description
search	string	Yes	Search term for location (city, county, state, or ZIP code).
key	string	Yes	Your API key.

Example Response

{
  "locations": [
    {
      "city": "Orlando",
      "countyName": "Orange",
      "countyID": "FL095",
      "stateID": 11,
      "stateName": "Florida",
      "stateAbbr": "FL"
    }
  ]
}

---

Usage Examples

Here are common workflows for using the API to pull provider results:

Example 1: Search Providers by State and Category

// Get providers for Florida, Public Adjusters category
GET /v1/providers?state=FL&category=0100&key=YOUR_API_KEY

// Or use category name instead of ID
GET /v1/providers?state=FL&category=Public%20Adjusters&key=YOUR_API_KEY

Example 2: Search Providers by County

// Get providers for Orange County, Florida
GET /v1/providers?state=FL&county=FL095&category=0100&key=YOUR_API_KEY

Example 3: National Search

// Search nationwide providers (omit state parameter)
GET /v1/providers?category=0100&key=YOUR_API_KEY

Example 4: Location Autocomplete

// Search for locations (cities, counties, states, ZIP codes)
GET /v1/locations?search=Orlando&key=YOUR_API_KEY

Example 5: Get Provider Details

// Get detailed provider information
GET /v1/providers/profile?providerID=1234&phone=5551234567&key=YOUR_API_KEY

---

Remaining Items to Build

The following endpoints and features are planned for future development:

• Provider Search by Name/Company - Search providers by business name
• Provider Search by Phone - Find providers by phone number
• Provider Search by ZIP Code - Search providers within a ZIP code radius
• Provider Reviews/Testimonials - Retrieve provider reviews and ratings
• Provider Images/Banners - Access provider banner images and logos
• Bulk Data Export - Download large datasets in CSV/JSON format
• Webhook Support - Receive notifications when provider data changes
• Rate Limiting Information - Endpoint to check current rate limit status
• API Usage Statistics - View your API usage and statistics

If you need any of these features, please contact support@claimspages.com to discuss your requirements.

---

Error Responses

HTTP Code	Meaning
200	Success
400	Bad Request (Invalid or missing parameters)
401	Unauthorized (Missing or invalid API key)
404	Not Found (No results)
500	Internal Server Error

For API access or support, contact: support@claimspages.com