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

# Check a Mobile Number Claim

> A `POST` to the `/profiles/{profileId}/mobile/check` endpoint lists every other profile that holds a mobile number: whether each has transactions or a balance worth recovering, and a masked hint of its email. An empty list means nobody else holds it. It never returns another profile's id or name. Call it only after the customer has proved they own the number.



## OpenAPI

````yaml post /v3/profiles/{profile}/mobile/check
openapi: 3.1.0
info:
  title: Omneo
  version: 0.0.1
servers:
  - url: https://api.{tenant}.getomneo.com/api
    variables:
      tenant:
        default: example
security: []
paths:
  /v3/profiles/{profile}/mobile/check:
    post:
      tags:
        - Profile Mobile Claim
      summary: Check a Mobile Number Claim
      description: >-
        A `POST` to the `/profiles/{profileId}/mobile/check` endpoint lists
        every other profile that holds a mobile number: whether each has
        transactions or a balance worth recovering, and a masked hint of its
        email. An empty list means nobody else holds it. It never returns
        another profile's id or name. Call it only after the customer has proved
        they own the number.
      operationId: profileMobileClaim.check
      parameters:
        - name: profile
          in: path
          required: true
          description: The profile ID
          schema:
            type: string
            format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CheckMobileClaim'
      responses:
        '200':
          description: Array of `MobileHolder`
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/MobileHolder'
                required:
                  - data
        '401':
          $ref: '#/components/responses/AuthenticationException'
        '403':
          $ref: '#/components/responses/AuthorizationException'
        '404':
          $ref: '#/components/responses/ModelNotFoundException'
        '422':
          $ref: '#/components/responses/ValidationException'
components:
  schemas:
    CheckMobileClaim:
      type: object
      properties:
        mobile_phone:
          type: string
      required:
        - mobile_phone
      title: CheckMobileClaim
    MobileHolder:
      type: object
      properties:
        has_history:
          type: string
        email_hint:
          type: string
      required:
        - has_history
        - email_hint
      title: MobileHolder
  responses:
    AuthenticationException:
      description: Unauthenticated
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                description: Error overview.
            required:
              - message
    AuthorizationException:
      description: Authorization error
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                description: Error overview.
            required:
              - message
    ModelNotFoundException:
      description: Not found
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                description: Error overview.
            required:
              - message
    ValidationException:
      description: Validation error
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                description: Errors overview.
              errors:
                type: object
                description: A detailed description of each field that failed validation.
                additionalProperties:
                  type: array
                  items:
                    type: string
            required:
              - message
              - errors

````

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