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

# Resolve a correlation claim for external intake

> Match consumer email and/or install address and return stable correlation claim identifiers for partner funnel integration.



## OpenAPI

````yaml https://api.prets.io/v1/openapi.json post /v1/correlation-claims/resolve
openapi: 3.1.0
info:
  title: Prets API
  version: 1.0.0
servers:
  - url: https://api.prets.app
security:
  - bearerAuth: []
paths:
  /v1/correlation-claims/resolve:
    post:
      summary: Resolve a correlation claim for external intake
      description: >-
        Match consumer email and/or install address and return stable
        correlation claim identifiers for partner funnel integration.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResolveCorrelationClaimRequest'
      responses:
        '200':
          description: Match result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResolveCorrelationClaimResponse'
        '401':
          description: Unauthorized
        '403':
          description: Caller org is not allowed to resolve correlation claims
components:
  schemas:
    ResolveCorrelationClaimRequest:
      anyOf:
        - type: object
          properties:
            email:
              type: string
              format: email
              description: Consumer email address
              example: jan.jansen@example.nl
            postalCode:
              type: string
              minLength: 1
              description: NL postal code (spaces optional)
              example: 1012AB
            houseNumber:
              type: string
              minLength: 1
              description: House number (addition ignored for matching)
              example: '12'
          required:
            - email
            - postalCode
            - houseNumber
        - type: object
          properties:
            postalCode:
              type: string
              minLength: 1
              description: NL postal code (spaces optional)
              example: 1012AB
            houseNumber:
              type: string
              minLength: 1
              description: House number (addition ignored for matching)
              example: '12'
          required:
            - postalCode
            - houseNumber
        - type: object
          properties:
            email:
              type: string
              format: email
              description: Consumer email address
              example: jan.jansen@example.nl
          required:
            - email
    ResolveCorrelationClaimResponse:
      type: object
      properties:
        data:
          oneOf:
            - $ref: '#/components/schemas/ResolveCorrelationClaimMatched'
            - $ref: '#/components/schemas/ResolveCorrelationClaimUnmatched'
          discriminator:
            propertyName: matched
            mapping:
              'true':
                $ref: '#/components/schemas/ResolveCorrelationClaimMatched'
              'false':
                $ref: '#/components/schemas/ResolveCorrelationClaimUnmatched'
      required:
        - data
    ResolveCorrelationClaimMatched:
      type: object
      properties:
        matched:
          type: boolean
          enum:
            - true
        correlationClaim:
          type: object
          properties:
            id:
              type: string
              pattern: ^crclm_[0-9A-HJKMNP-TV-Z]{26}$
              description: Canonical Prets correlation claim identifier
              example: crclm_01J0DQ4S20X2NM86ETPRV00QR0
            uuid:
              type: string
              pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i
              description: Lowercase UUID encoding of correlationClaim.id
              example: 01901b72-6440-e8ab-4419-dab636005f00
          required:
            - id
            - uuid
          description: Matched correlation claim identifiers
        correlationClaimId:
          type: string
          pattern: ^crclm_[0-9A-HJKMNP-TV-Z]{26}$
          deprecated: true
          description: Deprecated — use correlationClaim.id
          example: crclm_01J0DQ4S20X2NM86ETPRV00QR0
      required:
        - matched
        - correlationClaim
        - correlationClaimId
    ResolveCorrelationClaimUnmatched:
      type: object
      properties:
        matched:
          type: boolean
          enum:
            - false
      required:
        - matched
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````