Amass Cores/patentcore API

openapi: 3.2.0
info:
  title: Amass Tech Cores/patentcore API
  version: 1.0.0
  description: 'Operations tagged cores/patentcore across 2 of this provider''s published API definitions: amass-tech-openapi.json, api.amass.tech_openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.amass.tech
tags:
- name: cores/patentcore
paths:
  /api/v1/cores/patentcore/records:
    get:
      operationId: searchPatentCoreRecords
      tags:
      - cores/patentcore
      summary: Search
      description: Search PatentCore records (preview) by keyword query, optionally narrowed by jurisdiction, classification, assignee/inventor, dates, and citation count. Full-text BM25 over title, abstract, claims, and description.
      parameters:
      - schema:
          type: string
        required: true
        name: query
        in: query
      - schema:
          type: number
          minimum: 1
          maximum: 200
          default: 20
        required: false
        name: limit
        in: query
      - schema:
          type: string
          example: US,EP,WO
        required: false
        name: countryCode
        in: query
      - schema:
          type: string
          example: B2,A1
          description: Comma-separated WIPO ST.16 kind code(s) (e.g. A1, A2, B1, B2, U, S). Jurisdiction-specific and open-ended; match any.
        required: false
        description: Comma-separated WIPO ST.16 kind code(s) (e.g. A1, A2, B1, B2, U, S). Jurisdiction-specific and open-ended; match any.
        name: kindCode
        in: query
      - schema:
          type: string
          example: en
        required: false
        name: language
        in: query
      - schema:
          type: string
          example: A61K,C07D
        required: false
        name: cpcCodes
        in: query
      - schema:
          type: string
          example: A61K31/00
        required: false
        name: ipcCodes
        in: query
      - schema:
          type: string
          example: Moderna,BioNTech
        required: false
        name: assignee
        in: query
      - schema:
          type: string
          example: Doe
        required: false
        name: inventor
        in: query
      - schema:
          type: string
          enum:
          - 'true'
          - 'false'
          example: 'true'
        required: false
        name: hasClaims
        in: query
      - schema:
          type: string
          enum:
          - 'true'
          - 'false'
          example: 'true'
        required: false
        name: hasDescription
        in: query
      - schema:
          type: string
          format: date
          example: '2020-01-01'
        required: false
        name: minPublicationDate
        in: query
      - schema:
          type: string
          format: date
          example: '2024-12-31'
        required: false
        name: maxPublicationDate
        in: query
      - schema:
          type: string
          format: date
          example: '2018-01-01'
        required: false
        name: minFilingDate
        in: query
      - schema:
          type: string
          format: date
          example: '2024-12-31'
        required: false
        name: maxFilingDate
        in: query
      - schema:
          type: string
          format: date
          example: '2020-01-01'
        required: false
        name: minGrantDate
        in: query
      - schema:
          type: string
          format: date
          example: '2024-12-31'
        required: false
        name: maxGrantDate
        in: query
      - schema:
          type: string
          format: date
          example: '2015-01-01'
        required: false
        name: minPriorityDate
        in: query
      - schema:
          type: string
          format: date
          example: '2024-12-31'
        required: false
        name: maxPriorityDate
        in: query
      - schema:
          type: number
          example: 10
          minimum: 0
        required: false
        name: minCitedByCount
        in: query
      - schema:
          type: array
          items:
            type: string
            enum:
            - claims
            - description
            - nplCitations
            - citedByPatents
            - referencesDrugCore
            - referencesBiomedCore
        required: false
        name: include
        in: query
        style: form
        explode: true
      - schema:
          type: string
          example: Bearer ******
        required: false
        name: Authorization
        in: header
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/PatentCoreRecord'
                required:
                - data
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response_400'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response_401'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response_403'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response_404'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response_429'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response_500'
    servers:
    - url: https://api.amass.tech
  /api/v1/cores/patentcore/records/{amassId}:
    get:
      operationId: getPatentCoreRecordByAmassId
      tags:
      - cores/patentcore
      summary: Get record
      description: Get PatentCore record by Amass ID (preview)
      parameters:
      - schema:
          type: string
          example: AMPC_...
        required: true
        name: amassId
        in: path
      - schema:
          type: array
          items:
            type: string
            enum:
            - claims
            - description
            - nplCitations
            - citedByPatents
            - referencesDrugCore
            - referencesBiomedCore
        required: false
        name: include
        in: query
        style: form
        explode: true
      - schema:
          type: string
          example: Bearer ******
        required: false
        name: Authorization
        in: header
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/PatentCoreRecord'
                required:
                - data
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response_400'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response_401'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response_403'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response_404'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response_429'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response_500'
    servers:
    - url: https://api.amass.tech
  /api/v1/cores/patentcore/records/lookup:
    post:
      operationId: lookupPatentCoreRecords
      tags:
      - cores/patentcore
      summary: Lookup
      description: Lookup PatentCore records by publication number, application number, or family id (preview). Application number and family id can each resolve to several member publications, so those items may return multiple Amass IDs.
      parameters:
      - schema:
          type: string
          example: Bearer ******
        required: false
        name: Authorization
        in: header
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                items:
                  type: array
                  items:
                    anyOf:
                    - type: object
                      properties:
                        publicationNumber:
                          type: string
                      required:
                      - publicationNumber
                      additionalProperties: false
                    - type: object
                      properties:
                        applicationNumber:
                          type: string
                      required:
                      - applicationNumber
                      additionalProperties: false
                    - type: object
                      properties:
                        familyId:
                          type: string
                      required:
                      - familyId
                      additionalProperties: false
                    description: 'Look up patents by one of: publication number (one record), application number, or family id (both may resolve to several member publications).'
              required:
              - items
              example:
                items:
                - publicationNumber: US-10266485-B2
                - applicationNumber: US-15-123456
                - familyId: '12345678'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        input:
                          anyOf:
                          - type: object
                            properties:
                              publicationNumber:
                                type: string
                            required:
                            - publicationNumber
                            additionalProperties: false
                          - type: object
                            properties:
                              applicationNumber:
                                type: string
                            required:
                            - applicationNumber
                            additionalProperties: false
                          - type: object
                            properties:
                              familyId:
                                type: string
                            required:
                            - familyId
                            additionalProperties: false
                          description: 'Look up patents by one of: publication number (one record), application number, or family id (both may resolve to several member publications).'
                        amassIds:
                          type: array
                          items:
                            type: string
                            example: AMPC_...
                        error:
                          type: object
                          properties:
                            code:
                              type: string
                            message:
                              type: string
                          required:
                          - code
                          - message
                      required:
                      - input
                required:
                - data
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response_400'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response_401'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response_403'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response_404'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response_429'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response_500'
    servers:
    - url: https://api.amass.tech
components:
  schemas:
    PatentCoreRecord:
      type: object
      properties:
        amassId:
          type: string
        publicationNumber:
          type:
          - string
          - 'null'
          description: Publication number of the patent (e.g. US-10266485-B2). The source-neutral identity key.
        url:
          type:
          - string
          - 'null'
          description: Link to the source of this record. The target may change over time; use the identifier fields to build links to specific external systems.
        applicationNumber:
          type:
          - string
          - 'null'
          description: Application number of the patent.
        countryCode:
          type:
          - string
          - 'null'
          description: Jurisdiction / patent-office code (e.g. US, EP, WO, CN).
        kindCode:
          type:
          - string
          - 'null'
          description: Publication kind code indicating the document type/stage (e.g. A1, B2).
        familyId:
          type:
          - string
          - 'null'
          description: Patent family identifier grouping publications of the same invention across jurisdictions.
        familyMembers:
          type: array
          items:
            type: string
          description: PatentCore Amass IDs (AMPC_…) of the other members of this patent's family that were collapsed into this result (siblings across jurisdictions/stages) — dereference each via the get/batch endpoint. Empty when family collapse is off or no siblings were found.
        title:
          type:
          - string
          - 'null'
          description: Patent title (English-preferred).
        abstract:
          type:
          - string
          - 'null'
          description: Patent abstract (English-preferred).
        language:
          type:
          - string
          - 'null'
          description: Language of the full text.
        nonEnglishFallback:
          type:
          - boolean
          - 'null'
          description: True when the text is the original non-English language (no English text was available).
        cpcCodes:
          type: array
          items:
            type: string
          description: Cooperative Patent Classification (CPC) codes.
        ipcCodes:
          type: array
          items:
            type: string
          description: International Patent Classification (IPC) codes.
        inventors:
          type: array
          items:
            type: string
          description: Inventor names.
        assignees:
          type: array
          items:
            type: string
          description: Assignee / applicant names.
        publicationDate:
          type:
          - string
          - 'null'
          format: date
          description: Date the document entered the public record (~18 months after filing for applications).
          example: '2019-04-23'
        filingDate:
          type:
          - string
          - 'null'
          format: date
          description: Date this application was filed at this office; anchors the 20-year term.
          example: '2016-01-01'
        grantDate:
          type:
          - string
          - 'null'
          format: date
          description: Grant/issue date; null for pending or never-granted applications, so a grant-date filter implicitly restricts to granted patents.
          example: '2019-04-23'
        priorityDate:
          type:
          - string
          - 'null'
          format: date
          description: Earliest priority date — the invention's effective date and the correct field for prior-art and innovation-trend queries.
          example: '2015-01-01'
        citedPatents:
          type: array
          items:
            type: string
          description: 'BACKWARD citations (prior art this patent cites): PatentCore Amass IDs (AMPC_…) of the earlier patents THIS patent points to — dereference each via the get/batch endpoint. Returned by default. Cited patents outside our life-science corpus are dropped, so this list can be shorter than the patent''s true backward-citation count.'
        priorityClaimNumbers:
          type: array
          items:
            type: string
          description: Publication numbers claimed as priority.
        parentPublicationNumbers:
          type: array
          items:
            type: string
          description: Parent publication numbers in the lineage.
        childPublicationNumbers:
          type: array
          items:
            type: string
          description: Child publication numbers in the lineage.
        hasClaims:
          type:
          - boolean
          - 'null'
          description: Whether the patent has claims text.
        hasDescription:
          type:
          - boolean
          - 'null'
          description: Whether the patent has a description.
        nplCount:
          type:
          - number
          - 'null'
          description: 'BACKWARD citation count: how many non-patent-literature references (papers, books, standards) this patent cites. The full list is opt-in via ?include=nplCitations, so this count is returned by default in its place.'
        citedByCount:
          type:
          - number
          - 'null'
          description: 'FORWARD citation count: how many LATER patents cite THIS one — a downstream-impact signal that grows over time. The list of those patents is opt-in via ?include=citedByPatents; this count stays exact even when that list is capped.'
        claims:
          type:
          - string
          - 'null'
          description: Full claims text. Included with ?include=claims.
        description:
          type:
          - string
          - 'null'
          description: Full description text. Included with ?include=description.
        nplCitations:
          type: array
          items:
            type: string
          description: 'BACKWARD citations: raw non-patent-literature reference strings (papers, books, standards) this patent cites. Count is nplCount. Included with ?include=nplCitations.'
        citedByPatents:
          type: array
          items:
            type: string
          description: 'FORWARD citations: PatentCore Amass IDs (AMPC_…) of LATER patents that cite THIS one (who points at it) — dereference each via the get/batch endpoint. Count is citedByCount, which stays exact even though this list drops citing patents outside our life-science corpus. Included with ?include=citedByPatents.'
        referencesDrugCore:
          type: array
          items:
            type: string
          description: 'Cross-core link to DrugCore: Amass IDs of DrugCore records (drugs) disclosed in or linked to this patent, resolved from the patent''s ChEMBL ids. Included with ?include=referencesDrugCore.'
        referencesBiomedCore:
          type: array
          items:
            type: string
          description: 'Cross-core link to BiomedCore: Amass IDs (AMBC_…) of BiomedCore papers this patent cites, resolved from the DOIs regex-extracted from its non-patent-literature citations. DOIs with no BiomedCore paper (outside our life-science corpus) are dropped. Included with ?include=referencesBiomedCore.'
      required:
      - amassId
      - publicationNumber
      - url
      - applicationNumber
      - countryCode
      - kindCode
      - familyId
      - familyMembers
      - title
      - abstract
      - language
      - nonEnglishFallback
      - cpcCodes
      - ipcCodes
      - inventors
      - assignees
      - publicationDate
      - filingDate
      - grantDate
      - priorityDate
      - citedPatents
      - priorityClaimNumbers
      - parentPublicationNumbers
      - childPublicationNumbers
      - hasClaims
      - hasDescription
      - nplCount
      - citedByCount
    Response_400:
      type: object
      properties:
        error:
          type: object
          properties:
            status:
              type: number
              enum:
              - 400
              example: 400
            code:
              type: string
              enum:
              - BAD_REQUEST
              example: BAD_REQUEST
            message:
              type: string
              example: Bad Request
            in:
              type: string
              example: query
            fields:
              type: object
              additionalProperties:
                type: string
              example:
                name: Invalid name
          required:
          - status
          - code
          - message
      required:
      - error
    Response_429:
      type: object
      properties:
        error:
          type: object
          properties:
            status:
              type: number
              enum:
              - 429
              example: 429
            code:
              type: string
              enum:
              - TOO_MANY_REQUESTS
              example: TOO_MANY_REQUESTS
            message:
              type: string
              example: Too Many Requests
            retryAfter:
              type: number
              example: 10
          required:
          - status
          - code
          - message
          - retryAfter
      required:
      - error
    Response_500:
      type: object
      properties:
        error:
          type: object
          properties:
            status:
              type: number
              enum:
              - 500
              example: 500
            code:
              type: string
              enum:
              - INTERNAL_SERVER_ERROR
              example: INTERNAL_SERVER_ERROR
            message:
              type: string
              example: Internal Server Error
          required:
          - status
          - code
          - message
      required:
      - error
    Response_404:
      type: object
      properties:
        error:
          type: object
          properties:
            status:
              type: number
              enum:
              - 404
              example: 404
            code:
              type: string
              enum:
              - NOT_FOUND
              example: NOT_FOUND
            message:
              type: string
              example: Not Found
          required:
          - status
          - code
          - message
      required:
      - error
    Response_403:
      type: object
      properties:
        error:
          type: object
          properties:
            status:
              type: number
              enum:
              - 403
              example: 403
            code:
              type: string
              enum:
              - FORBIDDEN
              example: FORBIDDEN
            message:
              type: string
              example: Forbidden
          required:
          - status
          - code
          - message
      required:
      - error
    Response_401:
      type: object
      properties:
        error:
          type: object
          properties:
            status:
              type: number
              enum:
              - 401
              example: 401
            code:
              type: string
              enum:
              - UNAUTHORIZED
              example: UNAUTHORIZED
            message:
              type: string
              example: Unauthorized
          required:
          - status
          - code
          - message
      required:
      - error
x-refined-from:
- amass-tech-openapi.json
- api.amass.tech_openapi.json