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

# Create port-in request

> Opens a port-in request (portability ticket) for a line. `lineId` is this service's line id and is forwarded to the Wave Portability API as `externalLineId`.



## OpenAPI

````yaml POST /port-in-requests
openapi: 3.1.0
info:
  title: Wave Lines API
  version: 1.0.0
servers: []
security:
  - client_id: []
    secret_key: []
tags:
  - name: lines
    description: Line lifecycle operations
  - name: payments
    description: Payment listing and lookup
  - name: tax-receipts
    description: Tax receipt listing, lookup and document download
  - name: subscriptions
    description: Subscription lookup, product management and invoices
  - name: holders
    description: Holder (customer) listing, lookup and creation
  - name: usage
    description: 'Usage: per-product line balance and consumption'
  - name: Portability
    description: >-
      Number portability: port-in request creation, listing, modification and
      cancellation, plus the consolidated portability status
  - name: Inventory
    description: >-
      Inventory resource pools: pool listing, the resources held in a pool and
      resource reservations
  - name: Catalog
    description: Catalog offers exposed by the Wave Catalog API
paths:
  /port-in-requests:
    post:
      tags:
        - Portability
      summary: Create port in
      description: >-
        Opens a port-in request (portability ticket) for a line. `lineId` is
        this service's line id and is forwarded to the Wave Portability API as
        `externalLineId`.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                msisdn:
                  type: string
                  pattern: ^[0-9]+$
                  minLength: 11
                  maxLength: 13
                lineId:
                  type: string
                  format: uuid
                isPortIntra:
                  type: boolean
                  default: false
                holder:
                  type: object
                  properties:
                    name:
                      type: string
                      minLength: 1
                    taxId:
                      type: string
                      pattern: ^[0-9]+$
                      minLength: 11
                      maxLength: 14
                    externalCode:
                      type: string
                  required:
                    - name
                    - taxId
                  additionalProperties: false
                externalCode:
                  type: string
                executionWindowStartDatetime:
                  type: string
                  format: date-time
                tenantId:
                  type: string
                metadata:
                  type: object
                  additionalProperties:
                    type:
                      - string
                      - number
                      - boolean
              required:
                - msisdn
                - lineId
                - holder
              additionalProperties: false
        required: true
      responses:
        '201':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  lineId:
                    type: string
                  msisdn:
                    type: string
                  status:
                    type: string
                    enum:
                      - CREATED
                      - REQUESTED
                      - FAILED
                      - CANCELED
                      - CONFLICT
                      - MODIFIED
                      - PENDING
                      - COMPLETED
                      - EXECUTED
                  isPortIntra:
                    type: boolean
                  provider:
                    anyOf:
                      - type: object
                        properties:
                          id:
                            type: string
                          name:
                            type: string
                        required:
                          - id
                          - name
                        additionalProperties: false
                      - type: 'null'
                  holder:
                    type: object
                    properties:
                      id:
                        type: string
                      name:
                        type: string
                      taxId:
                        type: string
                      externalCode:
                        type: string
                      createdAt:
                        type: string
                      updatedAt:
                        type: string
                    required:
                      - id
                      - name
                      - taxId
                      - createdAt
                    additionalProperties: false
                  history:
                    type: array
                    items:
                      type: object
                      properties:
                        status:
                          type: string
                          enum:
                            - CREATED
                            - REQUESTED
                            - FAILED
                            - CANCELED
                            - CONFLICT
                            - MODIFIED
                            - PENDING
                            - COMPLETED
                            - EXECUTED
                        createdAt:
                          type: string
                        description:
                          type: string
                        metadata:
                          anyOf:
                            - type: object
                              additionalProperties:
                                type:
                                  - string
                                  - number
                                  - boolean
                            - type: 'null'
                      required:
                        - status
                        - createdAt
                        - description
                        - metadata
                      additionalProperties: false
                  cancelPortInRequests:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        status:
                          type: string
                          enum:
                            - CREATED
                            - REQUESTED
                            - CANCELED
                            - REJECTED
                        portInRequestId:
                          type: string
                        createdAt:
                          type: string
                        updatedAt:
                          type: string
                      required:
                        - id
                        - status
                        - portInRequestId
                        - createdAt
                      additionalProperties: false
                  externalTicketId:
                    type: string
                  externalCode:
                    type: string
                  tenantId:
                    type: string
                  executionWindowStartDatetime:
                    type: string
                  metadata:
                    type: object
                    additionalProperties:
                      type:
                        - string
                        - number
                        - boolean
                  createdAt:
                    type: string
                  updatedAt:
                    type: string
                required:
                  - id
                  - lineId
                  - msisdn
                  - status
                  - isPortIntra
                  - provider
                  - holder
                  - history
                  - cancelPortInRequests
                  - createdAt
                additionalProperties: false
components:
  securitySchemes:
    client_id:
      type: apiKey
      in: header
      name: client_id
    secret_key:
      type: apiKey
      in: header
      name: secret_key

````