> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quoindata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search records

> Filter one record kind in one jurisdiction on the source's own fields. Also used for owner lookup. Billable per page with results; empty results are free.



## OpenAPI

````yaml /openapi.json get /api/v4/search
openapi: 3.1.0
info:
  title: Quoin Property API
  version: quoin-v4
  description: Cited property records for Washington, D.C., Maryland and Northern Virginia.
servers:
  - url: https://portal.quoindata.com
security: []
tags:
  - name: Lookups
  - name: Property data
  - name: Search
paths:
  /api/v4/search:
    get:
      tags:
        - Search
      summary: Search records
      description: >-
        Filter one record kind in one jurisdiction on the source's own fields.
        Also used for owner lookup. Billable per page with results; empty
        results are free.
      operationId: search
      parameters:
        - name: Idempotency-Key
          in: header
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 256
          description: >-
            A unique value per logical call. Retrying with the same key within
            seven days returns the stored response at no charge.
        - name: jurisdiction
          in: query
          required: true
          description: State or county code to search in.
          schema:
            type: string
            enum:
              - '11'
              - '24'
              - '51'
              - '11001'
              - '24001'
              - '24003'
              - '24005'
              - '24009'
              - '24011'
              - '24013'
              - '24015'
              - '24017'
              - '24019'
              - '24021'
              - '24023'
              - '24025'
              - '24027'
              - '24029'
              - '24031'
              - '24033'
              - '24035'
              - '24037'
              - '24039'
              - '24041'
              - '24043'
              - '24045'
              - '24047'
              - '24510'
              - '51013'
              - '51059'
              - '51107'
              - '51510'
              - '51600'
              - '51610'
        - name: kind
          in: query
          required: true
          description: >-
            Record kind to search, for example sale, permit, account or
            ownership. catalog lists the kinds.
          schema:
            type: string
            pattern: ^[a-z_]{1,40}$
        - name: filter
          in: query
          required: false
          description: >-
            URL-encoded JSON object of up to 5 source fields, for example
            {"PRICE":{"gte":1000000}}. A bare value means eq. "$source_id"
            limits the search to one source.
          schema:
            type: string
            maxLength: 2000
        - name: cursor
          in: query
          required: false
          description: next_cursor from the previous page.
          schema:
            type: string
            maxLength: 512
        - name: limit
          in: query
          required: false
          description: Results per page, 1–100. Default 50.
          schema:
            default: 50
            type: integer
            minimum: 1
            maximum: 100
      responses:
        '200':
          description: Success
          headers:
            X-Quoin-Charged-Micro-USD:
              schema:
                type: integer
              description: >-
                Amount charged for this call in millionths of a dollar. 0 for
                free calls and replays.
            X-Quoin-Balance-Micro-USD:
              schema:
                type: integer
              description: Remaining account credit in millionths of a dollar.
            X-Quoin-Replayed:
              schema:
                type: string
              description: >-
                true when the response is a stored replay of an earlier call
                with the same Idempotency-Key.
            X-RateLimit-Remaining:
              schema:
                type: integer
              description: Calls left in the current minute.
          content:
            application/json:
              schema:
                type: object
                required:
                  - contract_version
                  - request_id
                  - operation
                  - status
                  - data
                  - error
                  - meta
                properties:
                  contract_version:
                    const: quoin-v4
                  request_id:
                    type: string
                    description: Your Idempotency-Key, or a generated id.
                  operation:
                    type: string
                  status:
                    enum:
                      - ok
                      - error
                  data:
                    type: object
                    properties:
                      items:
                        type: array
                        items:
                          type: object
                          properties:
                            record_ref:
                              type: string
                            kind:
                              type: string
                            source_id:
                              type: string
                            jurisdiction:
                              type:
                                - string
                                - 'null'
                            published_at:
                              type: string
                              format: date-time
                            citation:
                              type: object
                              properties:
                                source:
                                  type:
                                    - string
                                    - 'null'
                                dataset:
                                  type:
                                    - string
                                    - 'null'
                                as_of:
                                  type:
                                    - string
                                    - 'null'
                              required:
                                - source
                                - dataset
                                - as_of
                              additionalProperties: {}
                              description: >-
                                Publisher, dataset and the date Quoin published
                                the data.
                            data:
                              description: >-
                                The full source row, with field names as the
                                publisher wrote them.
                            q_ids:
                              description: Entities the record is about.
                          required:
                            - record_ref
                            - kind
                            - source_id
                            - jurisdiction
                            - published_at
                            - citation
                            - data
                            - q_ids
                          additionalProperties: false
                      next_cursor:
                        type: string
                        description: >-
                          Present when more results exist. Pass it back as
                          cursor.
                  error:
                    anyOf:
                      - type: object
                        properties:
                          code:
                            type: string
                            description: Stable machine-readable code. See Errors.
                          message:
                            type: string
                          retryable:
                            type: boolean
                      - type: 'null'
                  meta:
                    type: object
                    properties:
                      served_at:
                        type: string
                        format: date-time
                      next_cursor:
                        type:
                          - string
                          - 'null'
        '400':
          description: Invalid request. Not charged.
          content:
            application/json:
              schema:
                type: object
                required:
                  - contract_version
                  - request_id
                  - operation
                  - status
                  - data
                  - error
                  - meta
                properties:
                  contract_version:
                    const: quoin-v4
                  request_id:
                    type: string
                    description: Your Idempotency-Key, or a generated id.
                  operation:
                    type: string
                  status:
                    enum:
                      - ok
                      - error
                  data:
                    type: 'null'
                  error:
                    anyOf:
                      - type: object
                        properties:
                          code:
                            type: string
                            description: Stable machine-readable code. See Errors.
                          message:
                            type: string
                          retryable:
                            type: boolean
                      - type: 'null'
                  meta:
                    type: object
                    properties:
                      served_at:
                        type: string
                        format: date-time
                      next_cursor:
                        type:
                          - string
                          - 'null'
        '401':
          description: Missing or revoked API key. Not charged.
          content:
            application/json:
              schema:
                type: object
                required:
                  - contract_version
                  - request_id
                  - operation
                  - status
                  - data
                  - error
                  - meta
                properties:
                  contract_version:
                    const: quoin-v4
                  request_id:
                    type: string
                    description: Your Idempotency-Key, or a generated id.
                  operation:
                    type: string
                  status:
                    enum:
                      - ok
                      - error
                  data:
                    type: 'null'
                  error:
                    anyOf:
                      - type: object
                        properties:
                          code:
                            type: string
                            description: Stable machine-readable code. See Errors.
                          message:
                            type: string
                          retryable:
                            type: boolean
                      - type: 'null'
                  meta:
                    type: object
                    properties:
                      served_at:
                        type: string
                        format: date-time
                      next_cursor:
                        type:
                          - string
                          - 'null'
        '402':
          description: Credit used up and no payment method. Not charged.
          content:
            application/json:
              schema:
                type: object
                required:
                  - contract_version
                  - request_id
                  - operation
                  - status
                  - data
                  - error
                  - meta
                properties:
                  contract_version:
                    const: quoin-v4
                  request_id:
                    type: string
                    description: Your Idempotency-Key, or a generated id.
                  operation:
                    type: string
                  status:
                    enum:
                      - ok
                      - error
                  data:
                    type: 'null'
                  error:
                    anyOf:
                      - type: object
                        properties:
                          code:
                            type: string
                            description: Stable machine-readable code. See Errors.
                          message:
                            type: string
                          retryable:
                            type: boolean
                      - type: 'null'
                  meta:
                    type: object
                    properties:
                      served_at:
                        type: string
                        format: date-time
                      next_cursor:
                        type:
                          - string
                          - 'null'
        '403':
          description: Account suspended. Not charged.
          content:
            application/json:
              schema:
                type: object
                required:
                  - contract_version
                  - request_id
                  - operation
                  - status
                  - data
                  - error
                  - meta
                properties:
                  contract_version:
                    const: quoin-v4
                  request_id:
                    type: string
                    description: Your Idempotency-Key, or a generated id.
                  operation:
                    type: string
                  status:
                    enum:
                      - ok
                      - error
                  data:
                    type: 'null'
                  error:
                    anyOf:
                      - type: object
                        properties:
                          code:
                            type: string
                            description: Stable machine-readable code. See Errors.
                          message:
                            type: string
                          retryable:
                            type: boolean
                      - type: 'null'
                  meta:
                    type: object
                    properties:
                      served_at:
                        type: string
                        format: date-time
                      next_cursor:
                        type:
                          - string
                          - 'null'
        '404':
          description: Not found, or no search matches. Not charged.
          content:
            application/json:
              schema:
                type: object
                required:
                  - contract_version
                  - request_id
                  - operation
                  - status
                  - data
                  - error
                  - meta
                properties:
                  contract_version:
                    const: quoin-v4
                  request_id:
                    type: string
                    description: Your Idempotency-Key, or a generated id.
                  operation:
                    type: string
                  status:
                    enum:
                      - ok
                      - error
                  data:
                    type: 'null'
                  error:
                    anyOf:
                      - type: object
                        properties:
                          code:
                            type: string
                            description: Stable machine-readable code. See Errors.
                          message:
                            type: string
                          retryable:
                            type: boolean
                      - type: 'null'
                  meta:
                    type: object
                    properties:
                      served_at:
                        type: string
                        format: date-time
                      next_cursor:
                        type:
                          - string
                          - 'null'
        '409':
          description: Idempotency-Key reused for a different request. Not charged.
          content:
            application/json:
              schema:
                type: object
                required:
                  - contract_version
                  - request_id
                  - operation
                  - status
                  - data
                  - error
                  - meta
                properties:
                  contract_version:
                    const: quoin-v4
                  request_id:
                    type: string
                    description: Your Idempotency-Key, or a generated id.
                  operation:
                    type: string
                  status:
                    enum:
                      - ok
                      - error
                  data:
                    type: 'null'
                  error:
                    anyOf:
                      - type: object
                        properties:
                          code:
                            type: string
                            description: Stable machine-readable code. See Errors.
                          message:
                            type: string
                          retryable:
                            type: boolean
                      - type: 'null'
                  meta:
                    type: object
                    properties:
                      served_at:
                        type: string
                        format: date-time
                      next_cursor:
                        type:
                          - string
                          - 'null'
        '422':
          description: Response too large. Not charged.
          content:
            application/json:
              schema:
                type: object
                required:
                  - contract_version
                  - request_id
                  - operation
                  - status
                  - data
                  - error
                  - meta
                properties:
                  contract_version:
                    const: quoin-v4
                  request_id:
                    type: string
                    description: Your Idempotency-Key, or a generated id.
                  operation:
                    type: string
                  status:
                    enum:
                      - ok
                      - error
                  data:
                    type: 'null'
                  error:
                    anyOf:
                      - type: object
                        properties:
                          code:
                            type: string
                            description: Stable machine-readable code. See Errors.
                          message:
                            type: string
                          retryable:
                            type: boolean
                      - type: 'null'
                  meta:
                    type: object
                    properties:
                      served_at:
                        type: string
                        format: date-time
                      next_cursor:
                        type:
                          - string
                          - 'null'
        '429':
          description: Rate limit reached. Not charged.
          content:
            application/json:
              schema:
                type: object
                required:
                  - contract_version
                  - request_id
                  - operation
                  - status
                  - data
                  - error
                  - meta
                properties:
                  contract_version:
                    const: quoin-v4
                  request_id:
                    type: string
                    description: Your Idempotency-Key, or a generated id.
                  operation:
                    type: string
                  status:
                    enum:
                      - ok
                      - error
                  data:
                    type: 'null'
                  error:
                    anyOf:
                      - type: object
                        properties:
                          code:
                            type: string
                            description: Stable machine-readable code. See Errors.
                          message:
                            type: string
                          retryable:
                            type: boolean
                      - type: 'null'
                  meta:
                    type: object
                    properties:
                      served_at:
                        type: string
                        format: date-time
                      next_cursor:
                        type:
                          - string
                          - 'null'
        '503':
          description: Timed out or temporarily unavailable; retry. Not charged.
          content:
            application/json:
              schema:
                type: object
                required:
                  - contract_version
                  - request_id
                  - operation
                  - status
                  - data
                  - error
                  - meta
                properties:
                  contract_version:
                    const: quoin-v4
                  request_id:
                    type: string
                    description: Your Idempotency-Key, or a generated id.
                  operation:
                    type: string
                  status:
                    enum:
                      - ok
                      - error
                  data:
                    type: 'null'
                  error:
                    anyOf:
                      - type: object
                        properties:
                          code:
                            type: string
                            description: Stable machine-readable code. See Errors.
                          message:
                            type: string
                          retryable:
                            type: boolean
                      - type: 'null'
                  meta:
                    type: object
                    properties:
                      served_at:
                        type: string
                        format: date-time
                      next_cursor:
                        type:
                          - string
                          - 'null'
      security:
        - bearer_auth: []
components:
  securitySchemes:
    bearer_auth:
      type: http
      scheme: bearer
      bearerFormat: API key
      description: Create a key at https://portal.quoindata.com/keys.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.