TEtelgea
Port-Ins

List port-ins for a number

Retrieves a paginated list of all port-in requests associated with a specific number. Use this to see the full porting history for a phone number, including completed, failed, and in-progress port-ins.

get/v1/port-ins/number/{numberId}

Request

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

Path parameters

numberIdstring uuid required

UUID of the number resource

Example:8238c1b9-c2c0-4455-9b03-4bd787052709

Query parameters

pageinteger

Page to return, starting at 1.

Example:1
pageSizeinteger

Items per page, at most 100. Defaults to 50.

Example:50

Response

Successfully retrieved port-ins for the specified number.

pageinteger required

The page these items came from.

pageSizeinteger required

Items per page, as requested.

itemsCountinteger required

Total items across all pages. Divide by pageSize to get the number of pages.

Example response

{
  "page": 1,
  "pageSize": 50,
  "itemsCount": 142,
  "items": [
    {
      "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.