TEtelgea
Port-Ins

Get port-in status

Retrieves the current status and details of a port-in request. Use this endpoint to track the progress of a submitted port-in through its lifecycle.

get/v1/port-ins/{portInId}

Request

  • Base URL
    https://api.telgea.com
  • Auth
    API key in header x-api-key

Path parameters

portInIdstring uuid required

UUID of the port-in request.

Example:c3d4e5f6-a7b8-9012-c345-678901234567

Response

Successfully retrieved port-in details.

idstring required

UUID of the port-in request.

countryCodestring required

Market the number is being ported into.

msisdnstring required

The number being ported, in E.164 format.

executionDatestring required

The porting date, as YYYY-MM-DD.

typestring nullable required

Port-in type this request was submitted under, or null when the donor needed none.

status'PENDING' | 'CREATED' | 'SUBMITTED' | 'ACCEPTED' | 'REJECTED' | 'SUCCEEDED' | 'FAILED' required

Current status of the port-in

numberIdstring required

UUID of the number this port-in creates. Use it to read the line once porting succeeds.

createdAtstring required

When the port-in was submitted, ISO 8601.

updatedAtstring required

When the port-in last changed status, ISO 8601.

Example response

{
  "id": "c3d4e5f6-a7b8-9012-c345-678901234567",
  "countryCode": "DE",
  "msisdn": "+4915112345678",
  "executionDate": "2027-03-01",
  "type": "personal",
  "status": "CREATED",
  "numberId": "8238c1b9-c2c0-4455-9b03-4bd787052709",
  "failure": {
    "reason": "AUTHORIZATION_CODE_INVALID",
    "field": "authorizationCode",
    "text": "Your authorization code was refused or has expired."
  },
  "createdAt": "2027-02-22T10:00:00Z",
  "updatedAt": "2027-02-22T10:00:00Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.