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

# v1.0.2.1

> Port-in expanded to a full 5-step lifecycle, new port-out section, and onboarding checklist updated to match.

<Info>
  **Version:** 1.0.2.1 · **Published:** May 21, 2026 · **Published by:** Telegent Platform Team
</Info>

This release updates the Best Practices guide and Partner Onboarding checklist to reflect the full port-in lifecycle and the addition of port-out support, based on an updated source document.

***

## Enhanced

<AccordionGroup>
  <Accordion title="Port-in expanded to a full 5-step lifecycle (Best Practices Reference — Section 8.2)">
    Section 8.2 has been rewritten from a 2-step flow to a complete 5-step lifecycle guide:

    1. **Eligibility** — check before collecting anything from the subscriber; go/no-go guidance based on the result
    2. **Submit** — save the `OrderId` from the response; all subsequent lifecycle calls key off it
    3. **Update** (`POST /v1.0/numbers/portin/update`) — correct name mismatches, wrong account numbers, or missing `PortInDate` without cancelling and resubmitting
    4. **Cancel** (`POST /v1.0/numbers/portin/cancel`) — cancel by `OrderId`; cancel is final
    5. **Monitor** (`GET /v1.0/numbers/order?OrderId=…`) — poll through `Submitted`, `Pending Carrier Approval`, `Scheduled`, `Completed`, `Rejected`, `Cancelled`

    Inline comments added to the eligibility and port-in submit request bodies. Best practice tip expanded to include polling cadence and subscriber notification guidance.
  </Accordion>

  <Accordion title="Port-out section added (Best Practices Reference — Section 8.3)">
    New Section 8.3 documents the port-out flow: the gaining carrier initiates the transfer, and the MVNO must issue a PIN via `POST /v1.0/numbers/portout`. Includes a callout on FCC obligations — issue the PIN promptly and do not suspend service before the port-out completes.
  </Accordion>

  <Accordion title="Phase 6 quick-start description updated (Best Practices Overview)">
    The Phase 6 step on the Best Practices Overview page now reflects the full port-in lifecycle and mentions port-out PIN issuance, replacing the previous single-sentence description.
  </Accordion>

  <Accordion title="Port-in and port-out testing tasks added to onboarding Phase 3">
    The Phase 3 API Walkthrough checklist now includes six additional tasks covering the full port-in lifecycle (eligibility, submit, update, cancel, monitor) and port-out PIN issuance. Both sections are marked as conditional — skip if porting is not in scope for the partner.
  </Accordion>
</AccordionGroup>

***

<Note>
  If you have questions about any of these changes, contact [support@telegent.com](mailto:support@telegent.com).
</Note>