ParseAPI Address API

A US address, checked against official records.

GitHub OpenAPI

Operations 2

GET /address/{address} Look up a US address #
GET /address Autocomplete a partial US address #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/parseapi-com:parseapi-com-address-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

parseapi-com-address-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Parse Address API
  version: 1.0.0
  summary: Fast APIs for developers, locate, validate, decode.
  description: 'One base URL, one key, minimal JSON. Response schemas describe API 2.3.0. Paid plans include their profile detail automatically at its natural resource homes; Free returns the complete ordinary answer. There is no deep response object. When neither version header is sent, requests use the saved team default, or 1.0.0 for keyless self-lookups. Read https://parseapi.com/docs/versioning for other supported contracts. Responses that reach the organization rate check carry X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset. Optional X-RateLimit-Burst indicates continuous refill. Rate-limit 429 responses add Retry-After (seconds). See https://parseapi.com/agents and https://parseapi.com/llms.txt for agent-oriented guidance. Field-level docs: https://parseapi.com/docs Free-plan users must include a link to ParseAPI on their website, app, or project documentation. A footer, about page, credits page, or another reasonable location is fine. Paid plans do not require ParseAPI attribution. Example HTML: Data provided by ParseAPI. Details: https://parseapi.com/legal/attribution#crediting-parseapi.'
  termsOfService: https://parseapi.com/legal/terms
  contact:
    name: ParseAPI
    email: hello@parseapi.com
    url: https://parseapi.com
servers:
- url: https://api.parseapi.com
  description: Production
tags:
- name: Address
  description: A US address, checked against official records.
  externalDocs:
    description: Address API docs
    url: https://parseapi.com/docs/address
paths:
  /address/{address}:
    get:
      operationId: address
      tags:
      - Address
      summary: Look up a US address
      description: 'Checks a US address against official records. registered means a record match, not postal deliverability. Junk returns 200 with valid false. Full field reference: https://parseapi.com/docs/address'
      security:
      - ApiKeyAuth: []
      - BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/ParseVersion'
      - name: country
        in: query
        required: false
        description: Address country. Current published coverage is US; defaults to US.
        schema:
          type: string
          example: US
      - name: address
        in: path
        required: true
        description: Supplied check value. Invalid values return HTTP 200 with valid false.
        schema:
          type: string
          example: 152 200th Avenue, Ellsworth MN
          maxLength: 4096
      responses:
        '200':
          description: Success, minimal JSON object (shape varies by endpoint)
          headers:
            X-RateLimit-Limit:
              description: Sustained requests per minute for your team
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Estimated requests available in the current window or token bucket
              schema:
                type: integer
            X-RateLimit-Reset:
              description: Seconds until the window resets, or until full bucket recovery with no more calls when X-RateLimit-Burst is present. On a 429 use Retry-After for the next attempt.
              schema:
                type: integer
            X-RateLimit-Burst:
              description: Optional token bucket capacity. When present, capacity replenishes continuously at X-RateLimit-Limit requests per minute.
              schema:
                type: integer
            X-API-Version:
              description: The exact response contract selected for this request.
              schema:
                type: string
                enum:
                - 1.0.0
                - 2.0.0
                - 2.1.0
                - 2.2.0
                - 2.3.0
          content:
            application/json:
              schema:
                type: object
                properties:
                  address:
                    type:
                    - string
                    - 'null'
                  valid:
                    type: boolean
                  registered:
                    type:
                    - boolean
                    - 'null'
                  number:
                    type:
                    - string
                    - 'null'
                  street:
                    type:
                    - string
                    - 'null'
                  unit:
                    type:
                    - string
                    - 'null'
                  postal:
                    type:
                    - string
                    - 'null'
                  city:
                    type:
                    - string
                    - 'null'
                  county:
                    type:
                    - string
                    - 'null'
                  county_name:
                    type:
                    - string
                    - 'null'
                  state:
                    type:
                    - string
                    - 'null'
                  state_name:
                    type:
                    - string
                    - 'null'
                  country:
                    type:
                    - string
                    - 'null'
                  country_name:
                    type:
                    - string
                    - 'null'
                  latitude:
                    type:
                    - number
                    - 'null'
                  longitude:
                    type:
                    - number
                    - 'null'
                required:
                - address
                - valid
                - registered
                - number
                - street
                - unit
                - city
                - county
                - county_name
                - state
                - state_name
                - postal
                - country
                - country_name
                - latitude
                - longitude
                additionalProperties: true
        '400':
          description: invalid_request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: invalid_api_key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: permission_denied or plan_required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: not_found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '410':
          description: api_version_retired
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: rate_limited or quota_exceeded
          headers:
            X-RateLimit-Limit:
              description: Sustained requests per minute for your team
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Estimated requests available in the current window or token bucket
              schema:
                type: integer
            X-RateLimit-Reset:
              description: Seconds until the window resets, or until full bucket recovery with no more calls when X-RateLimit-Burst is present. On a 429 use Retry-After for the next attempt.
              schema:
                type: integer
            X-RateLimit-Burst:
              description: Optional token bucket capacity. When present, capacity replenishes continuously at X-RateLimit-Limit requests per minute.
              schema:
                type: integer
            Retry-After:
              description: Seconds to wait before retrying
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: server_error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: service_unavailable
          headers:
            Retry-After:
              description: Seconds to wait before retrying
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /address:
    get:
      operationId: address_autocomplete
      tags:
      - Address
      summary: Autocomplete a partial US address
      description: 'Ranked suggestions from official US records. Pass postal or city and state from the form when you have them, otherwise the caller''s IP ranks the home city first. Suggestions never invent house numbers. Full field reference: https://parseapi.com/docs/address'
      security:
      - ApiKeyAuth: []
      - BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/ParseVersion'
      - name: country
        in: query
        required: false
        description: Address country. Current published coverage is US; defaults to US.
        schema:
          type: string
          example: US
      - name: q
        in: query
        required: true
        description: The partial address as typed
        schema:
          type: string
          example: 200th
      - name: postal
        in: query
        required: false
        description: Postal code scope from the form
        schema:
          type: string
          example: '56129'
      - name: city
        in: query
        required: false
        description: City scope; pair with state for the US
        schema:
          type: string
          example: Greensboro
      - name: state
        in: query
        required: false
        description: US state code
        schema:
          type: string
          example: NC
      - name: ip
        in: query
        required: false
        description: End-user IP for ranking bias when calling server-side
        schema:
          type: string
          example: 1.2.3.4
      responses:
        '200':
          description: Success, minimal JSON object (shape varies by endpoint)
          headers:
            X-RateLimit-Limit:
              description: Sustained requests per minute for your team
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Estimated requests available in the current window or token bucket
              schema:
                type: integer
            X-RateLimit-Reset:
              description: Seconds until the window resets, or until full bucket recovery with no more calls when X-RateLimit-Burst is present. On a 429 use Retry-After for the next attempt.
              schema:
                type: integer
            X-RateLimit-Burst:
              description: Optional token bucket capacity. When present, capacity replenishes continuously at X-RateLimit-Limit requests per minute.
              schema:
                type: integer
            X-API-Version:
              description: The exact response contract selected for this request.
              schema:
                type: string
                enum:
                - 1.0.0
                - 2.0.0
                - 2.1.0
                - 2.2.0
                - 2.3.0
          content:
            application/json:
              schema:
                type: object
                properties:
                  q:
                    type: string
                  postal:
                    type:
                    - string
                    - 'null'
                  city:
                    type:
                    - string
                    - 'null'
                  state:
                    type:
                    - string
                    - 'null'
                  country:
                    type:
                    - string
                    - 'null'
                  addresses:
                    type: array
                    items:
                      type: object
                      properties:
                        address:
                          type: string
                        number:
                          type:
                          - string
                          - 'null'
                        street:
                          type:
                          - string
                          - 'null'
                        unit:
                          type:
                          - string
                          - 'null'
                        postal:
                          type:
                          - string
                          - 'null'
                        city:
                          type:
                          - string
                          - 'null'
                        state:
                          type:
                          - string
                          - 'null'
                        latitude:
                          type:
                          - number
                          - 'null'
                        longitude:
                          type:
                          - number
                          - 'null'
                      required:
                      - address
                      - number
                      - street
                      - unit
                      - city
                      - state
                      - postal
                      - latitude
                      - longitude
                      additionalProperties: true
                  reason:
                    type:
                    - string
                    - 'null'
                    description: Null when suggestions exist. more_input asks for more street input; missing_context asks for a postal code or city and state; no_matches means the completed search found nothing. Additional reasons may be added. Unavailable search services return 503.
                required:
                - q
                - addresses
                - reason
                additionalProperties: true
        '400':
          description: invalid_request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: invalid_api_key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: permission_denied or plan_required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: not_found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '410':
          description: api_version_retired
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: rate_limited or quota_exceeded
          headers:
            X-RateLimit-Limit:
              description: Sustained requests per minute for your team
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Estimated requests available in the current window or token bucket
              schema:
                type: integer
            X-RateLimit-Reset:
              description: Seconds until the window resets, or until full bucket recovery with no more calls when X-RateLimit-Burst is present. On a 429 use Retry-After for the next attempt.
              schema:
                type: integer
            X-RateLimit-Burst:
              description: Optional token bucket capacity. When present, capacity replenishes continuously at X-RateLimit-Limit requests per minute.
              schema:
                type: integer
            Retry-After:
              description: Seconds to wait before retrying
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: server_error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: service_unavailable
          headers:
            Retry-After:
              description: Seconds to wait before retrying
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  parameters:
    ParseVersion:
      name: X-API-Version
      in: header
      required: false
      description: Exact response contract for this lookup. Overrides the saved team default for this request only. Legacy Parse-Version is also accepted; both headers must match if sent together. With neither header, keyed requests use that default and keyless self-lookups use 1.0.0. Invalid or unsupported values return invalid_request (400). Retired selections return api_version_retired (410). Reference/help URLs keep their documented version and do not use this selector.
      schema:
        type: string
        enum:
        - 1.0.0
        - 2.0.0
        - 2.1.0
        - 2.2.0
        - 2.3.0
        example: 2.3.0
  schemas:
    Error:
      type: object
      required:
      - code
      - message
      - docs
      - request_id
      properties:
        code:
          type: string
          description: Machine-readable error code
          enum:
          - invalid_request
          - ambiguous_time
          - nonexistent_time
          - invalid_api_key
          - permission_denied
          - plan_required
          - not_found
          - api_version_retired
          - rate_limited
          - quota_exceeded
          - server_error
          - service_unavailable
          - dns_resolution_failed
          - task_invalid
          - task_not_found
          - task_request_conflict
          - task_budget_exceeded
          - task_limit_exceeded
          - task_terms_changed
          - task_expired
          - task_cancelled
          - task_in_progress
          - task_outcome_unknown
          - task_unavailable
        message:
          type: string
        docs:
          type: string
          format: uri
          description: Link to the docs section for this error
        request_id:
          type: string
          description: Send this if you contact support
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key from the ParseAPI dashboard
    BearerAuth:
      type: http
      scheme: bearer
      description: 'Same key as X-API-Key, via Authorization: Bearer'