Api Endpoint

Scrapebench API

Look up New Mexico contractor licences (Construction Industries Division) by licence number, business name, city, ZIP or status, returning status, expiry and business address. Every licence PSI Exams lists for NM CID, active and lapsed, refreshed monthly.

Open interactive test console

Offering

Provider
api.scrapebench.dev
Method
POST
Offering type
Api Endpoint
Transport type
http
Category
Other
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://api.scrapebench.dev/v1/nm-contractor-licenses
MIME type
Not provided
First seen
2026-10-25T21:34:56.095Z
Last seen
Tags
contractors, licenses, new-mexico, public-records, Verification

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.08 USDC
Atomic price: 80000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "80000",
    "payTo": "0x1bd1e9431c00ba6ff992a3dda541282079d02abf"
  }
]

Observed health

Status
Reachable
Latest latency
273 ms
Average latency
1094 ms
HTTP status
405
Last checked
Reachability
100% over 5 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "body": {
      "properties": {
        "city": {
          "anyOf": [
            {
              "maxLength": 100,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Business city, exact match ignoring case, e.g. 'Albuquerque'.",
          "title": "City"
        },
        "license_number": {
          "anyOf": [
            {
              "maxLength": 20,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Exact NM CID licence number, e.g. '1010'.",
          "title": "License Number"
        },
        "name": {
          "anyOf": [
            {
              "maxLength": 100,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Case-insensitive substring of the business name.",
          "title": "Name"
        },
        "purpose": {
          "anyOf": [
            {
              "maxLength": 200,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Optional: what you need this data for, in one sentence (e.g. 'vetting a roofer before hiring'). It never changes the price or the rows; it tells us what to improve.",
          "title": "Purpose"
        },
        "status": {
          "anyOf": [
            {
              "maxLength": 20,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Licence status, ignoring case: one of Active, Cancelled, Revoked, Suspended, Inactive, Expired, Inspector. Default: every status.",
          "title": "Status"
        },
        "zip_code": {
          "anyOf": [
            {
              "maxLength": 10,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "ZIP code or its leading digits, e.g. '871'.",
          "title": "Zip Code"
        }
      },
      "title": "Input",
      "type": "object"
    },
    "bodyType": {
      "enum": [
        "json",
        "form-data",
        "text"
      ],
      "type": "string"
    },
    "method": {
      "enum": [
        "POST",
        "PUT",
        "PATCH"
      ],
      "type": "string"
    },
    "type": {
      "const": "http",
      "type": "string"
    }
  },
  "required": [
    "type",
    "method",
    "bodyType",
    "body"
  ],
  "type": "object"
}

Output schema

{
  "properties": {
    "example": {
      "properties": {
        "next_page": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "description": "Page to request next, or null when this is the last.",
          "title": "Next Page"
        },
        "page": {
          "description": "Zero-based page number of this response.",
          "title": "Page",
          "type": "integer"
        },
        "page_size": {
          "description": "Most rows a page can hold; one page is one price.",
          "title": "Page Size",
          "type": "integer"
        },
        "rows": {
          "description": "Data rows, or free Notice rows explaining a gap.",
          "items": {
            "anyOf": [
              {
                "additionalProperties": false,
                "properties": {
                  "address": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "Principal place of business, street or PO box.",
                    "title": "Address"
                  },
                  "business_name": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "Licensed business name as CID lists it.",
                    "title": "Business Name"
                  },
                  "city": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "Business city (some licensees are out of state).",
                    "title": "City"
                  },
                  "expiration_date": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "Licence expiry, MM/DD/YYYY as CID writes it.",
                    "title": "Expiration Date"
                  },
                  "license_number": {
                    "description": "NM CID contractor licence number.",
                    "title": "License Number",
                    "type": "string"
                  },
                  "scraped_at": {
                    "description": "UTC timestamp of scrape.",
                    "format": "date-time",
                    "title": "Scraped At",
                    "type": "string"
                  },
                  "source_url": {
                    "description": "The URL or endpoint this record was scraped from.",
                    "title": "Source Url",
                    "type": "string"
                  },
                  "status": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "Licence status: Active, Cancelled, Revoked, Suspended, Inactive, Expired, Inspector.",
                    "title": "Status"
                  },
                  "zip_code": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "Business ZIP, with the +4 extension when CID has one.",
                    "title": "Zip Code"
                  }
                },
                "required": [
                  "source_url",
                  "license_number"
                ],
                "title": "Output",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "description": "A free row explaining why a page has no (or partial) data. Never charged.",
                "properties": {
                  "notice": {
                    "description": "Human-readable reason, and what to send instead if the input was the problem.",
                    "title": "Notice",
                    "type": "string"
                  },
                  "notice_type": {
                    "default": "input_error",
                    "description": "Machine-readable reason: input_error, no_results, blocked, truncated, source_changed, not_ready or stale.",
                    "title": "Notice Type",
                    "type": "string"
                  },
                  "scraped_at": {
                    "description": "UTC timestamp of scrape.",
                    "format": "date-time",
                    "title": "Scraped At",
                    "type": "string"
                  },
                  "source_url": {
                    "default": "",
                    "description": "Empty: a notice is about the request, not about a page.",
                    "title": "Source Url",
                    "type": "string"
                  }
                },
                "required": [
                  "notice"
                ],
                "title": "Notice",
                "type": "object"
              }
            ]
          },
          "title": "Rows",
          "type": "array"
        },
        "service": {
          "description": "The service that answered.",
          "title": "Service",
          "type": "string"
        }
      },
      "required": [
        "service",
        "page",
        "page_size",
        "next_page",
        "rows"
      ],
      "title": "NmContractorLicensesPage",
      "type": "object"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}