# Lookup number

Performs a number lookup. You can make a minimal request or add additional options to the  array.

Endpoint: POST /v2/projects/{projectId}/lookups
Version: 0.1.0
Security: Basic, OAuth2

## Path parameters:

  - `projectId` (string, required)

## Request fields (application/json):

  - `number` (string, required)
    MSISDN in E.164 format to query.
    Example: "+12312312312"

  - `features` (array)
    Contains requested features. Fallback to LineType if not provided.
    Enum: "LineType", "SimSwap", "VoIPDetection", "RND"

  - `rndFeatureOptions` (object,null)
    Required when RND feature is requested.

  - `rndFeatureOptions.contactDate` (string)
    Last contact date in YYYY-MM-DD format.

## Response 200 fields (application/json):

  - `line` (object,null)
    An object containing information about the line type of the number.

  - `line.carrier` (string,null)
    Name of the carrier.
    Example: "T-Mobile USA"

  - `line.type` (string,null)
    Number type e.g. wireless, mobile, fixed.
    Enum: "Landline", "Mobile", "VoIP", "Special", "Freephone", "Other"

  - `line.mobileCountryCode` (string,null)
    A numeric code (MCC) that uniquely identifies a country within the international telecommunications network.
    Example: "310"

  - `line.mobileNetworkCode` (string,null)
    A distinct identifier assigned to a mobile network operator within a specific country, used in combination with MCC.
    Example: "260"

  - `line.ported` (boolean,null)
    Indicates if a phone number has been transferred from its original network to a different provider.
    Example: true

  - `line.portingDate` (string,null)
    Specifies the date, in ISO 8601 format, when a phone number was transferred from its original network to a new provider.
    Example: "2000-01-01T00:00:00.0000000+00:00"

  - `line.error` (object,null)

  - `line.error.status` (integer)
    The error status code.

  - `line.error.title` (string)
    A short, human-readable summary of the error type.

  - `line.error.detail` (string)
    A human-readable explanation specific to this occurrence of the error.

  - `line.error.type` (string,null)
    A URI reference that identifies the error type.

  - `simSwap` (object,null)
    An object containing information about the SimSwap verification performed on the number.

  - `simSwap.swapped` (boolean,null)
    Indicates whether SIM was changed.
    Example: true

  - `simSwap.swapPeriod` (string,null)
    Threshold for sim swap check.
    Enum: "Undefined", "SP4H", "SP12H", "SP24H", "SP48H", "SP5D", "SP7D", "SP14D", "SP30D", "SPMAX"

  - `voIPDetection` (object,null)
    An object containing information about the VoIP detection performed on the number.

  - `voIPDetection.probability` (string,null)
    Probability of number being VoIP based on the AI analysis.
    Enum: "Unknown", "Low", "Likely", "High"

  - `rnd` (object,null)
    An object containing information whether number is disconnected.

  - `rnd.disconnected` (boolean,null)
    Provides information whether the number was disconnected after provided last contact date.

  - `countryCode` (string)
    ISO 3166-1 alpha-2 two-letter country identifier

  - `traceId` (string)
    The identifier for a trace.
    Example: "84c1fd4063c38d9f3900d06e56542d48"

  - `number` (string)
    Requested MSISDN in E.164 format.
    Example: "+12312312312"

## Response 400 fields (application/json):

  - `type` (string,null)
    A URI reference that identifies the problem type.

  - `title` (string)
    A short, human-readable summary of the problem type.

  - `status` (integer)
    The HTTP status code.

  - `traceId` (string)
    The identifier for a trace.
    Example: "00-84c1fd4063c38d9f3900d06e56542d48-85d1d4-00"

## Response 401 fields (application/json):

  - `type` (string,null)
    A URI reference that identifies the problem type.

  - `title` (string)
    A short, human-readable summary of the problem type.

  - `status` (integer)
    The HTTP status code.

  - `traceId` (string)
    The identifier for a trace.
    Example: "00-84c1fd4063c38d9f3900d06e56542d48-85d1d4-00"

## Response 402 fields (application/json):

  - `type` (string,null)
    A URI reference that identifies the problem type.

  - `title` (string)
    A short, human-readable summary of the problem type.

  - `status` (integer)
    The HTTP status code.

  - `traceId` (string)
    The identifier for a trace.
    Example: "00-84c1fd4063c38d9f3900d06e56542d48-85d1d4-00"

## Response 403 fields (application/json):

  - `type` (string,null)
    A URI reference that identifies the problem type.

  - `title` (string)
    A short, human-readable summary of the problem type.

  - `status` (integer)
    The HTTP status code.

  - `traceId` (string)
    The identifier for a trace.
    Example: "00-84c1fd4063c38d9f3900d06e56542d48-85d1d4-00"

## Response 404 fields (application/json):

  - `type` (string,null)
    A URI reference that identifies the problem type.

  - `title` (string)
    A short, human-readable summary of the problem type.

  - `status` (integer)
    The HTTP status code.

  - `traceId` (string)
    The identifier for a trace.
    Example: "00-84c1fd4063c38d9f3900d06e56542d48-85d1d4-00"

## Response 429 fields (application/json):

  - `type` (string,null)
    A URI reference that identifies the problem type.

  - `title` (string)
    A short, human-readable summary of the problem type.

  - `status` (integer)
    The HTTP status code.

  - `traceId` (string)
    The identifier for a trace.
    Example: "00-84c1fd4063c38d9f3900d06e56542d48-85d1d4-00"

## Response 500 fields (application/json):

  - `type` (string,null)
    A URI reference that identifies the problem type.

  - `title` (string)
    A short, human-readable summary of the problem type.

  - `status` (integer)
    The HTTP status code.

  - `traceId` (string)
    The identifier for a trace.
    Example: "00-84c1fd4063c38d9f3900d06e56542d48-85d1d4-00"