PULLFIRST[THE RECORD]

Quickstart

Sign in, create a key, make a request.

Sign in

Google sign-in creates a sandbox account with no credit card required. Sign in.

Create a key

From the dashboard, click Create API key. The full key is shown exactly once; copy and store it immediately. Keys start with sk_live_.

sk_live_a1b2c3d4e5f6...

Run a query

Send the key in the Authorization header using the Bearer scheme. List endpoints return a PagedResult<T> envelope.

Contractor lookup
curl "https://api.pullfirst.com/v1/licenses/search?q=Example+Electric" \
  -H "Authorization: Bearer sk_live_..."
Permits at an address
curl "https://api.pullfirst.com/v1/permits/address?address=123+Main+St&city=Minneapolis" \
  -H "Authorization: Bearer sk_live_..."

Example response:

{
  "data": [
    {
      "licenseNumber": "EA000000",
      "name": "EXAMPLE ELECTRICAL CONTRACTOR INC",
      "status": "Issued",
      "city": "MINNEAPOLIS",
      "state": "MN",
      "licenseType": "Electrical",
      "licenseSubtype": "Class A Electrical Contractor",
      "expirationDate": "2028-02-29",
      "hasEnforcementAction": false
    }
  ],
  "page": 1,
  "pageSize": 25,
  "totalCount": 1,
  "totalPages": 1
}

Integrate

Handle the error envelope documented in errors. Watch the rate-limit headers documented in rate limits. The full endpoint list is in the API reference.