> ## 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. # Order ID Details > Retrieve detailed information about a number provisioning order using the order ID. Returns order status, requested numbers, provisioning results, and any error messages. **What this does:** Returns the order status, order type (provision, portin, etc.), associated phone numbers, and any error message codes from the carrier. Multiple example responses are included showing common error states (account number required, number lock). Poll this endpoint after a provision or port-in to confirm completion. **Next steps:** - If status is Complete, the number is active — send a test message via `POST /v1.0/message/outbound` - If status is Error, review the `OrderStatusMessage` and retry the operation ## OpenAPI ````yaml /api-reference/openapi.json get /v1.0/numbers/order openapi: 3.0.3 info: title: mPaaS Core APIs version: 1.0.8 description: >- The Telegent mPaaS (Mobile Platform as a Service) API gives you full programmatic control over mobile phone numbers, messaging, voice routing, subscribers, and account management. Use these APIs to provision MVNO and IoT numbers, send and receive SMS/MMS, configure intelligent call routing, manage subscriber accounts, and apply AI Guardian controls. All requests require a Bearer token obtained from the Authentication endpoint. For support, visit https://support.telegent.com/support/home contact: name: Support email: support@telegent.com termsOfService: https://telegent.com/terms license: name: Use under LICX url: https://telegent.com/license servers: - url: https://api.telegent.com security: - BearerAuth: [] tags: - name: OAuth2 - name: AI Guardian - name: Accounts - name: Distributors - name: Message - name: Numbers - name: Voicemail - name: Packages - name: Products - name: Schedules - name: Services - name: Sims - name: Subscribers - name: Subscriptions - name: Voice - name: Workgroups paths: /v1.0/numbers/order: get: tags: - Numbers summary: Order ID Details description: >- Retrieve detailed information about a number provisioning order using the order ID. Returns order status, requested numbers, provisioning results, and any error messages. **What this does:** Returns the order status, order type (provision, portin, etc.), associated phone numbers, and any error message codes from the carrier. Multiple example responses are included showing common error states (account number required, number lock). Poll this endpoint after a provision or port-in to confirm completion. **Next steps:** - If status is Complete, the number is active — send a test message via `POST /v1.0/message/outbound` - If status is Error, review the `OrderStatusMessage` and retry the operation parameters: - name: OrderId in: query required: false schema: type: string description: The unique order ID to retrieve details for (e.g., JNUOID-xxxxx) responses: '200': description: Order ID Details content: application/json: schema: type: object examples: example1: summary: Error - Account Number Required or Incorrect value: OrderDate: '2025-12-08T00:12:08.89' OrderId: JNUOID-12390e1f-ef69-4d81-b97b-8d000e763ec9 OrderStatus: Error OrderStatusMessage: 8A-ACCOUNT_NUM_REQ_OR_INCORRECT OrderType: portin PhoneNumbersOrdered: - Number: '+12815703894' example2: summary: Error - Number Lock on Account value: OrderDate: '2025-12-08T00:21:41.29' OrderId: JNUOID-2961128e-6425-42b2-b062-84bc16300be0 OrderStatus: Error OrderStatusMessage: 6P-REMOVE NUMBER LOCK ON VERIZON ACCOUNT OrderType: portin PhoneNumbersOrdered: - Number: '+15094752007' '400': description: Bad Request content: text/plain: schema: $ref: '#/components/schemas/BadRequest_Result' application/json: schema: $ref: '#/components/schemas/BadRequest_Result' examples: example: value: StatusCode: 400 Message: >- Bad request: one or more required fields are missing or contain an invalid value. text/json: schema: $ref: '#/components/schemas/BadRequest_Result' '401': description: Unauthorized content: text/plain: schema: $ref: '#/components/schemas/Unauthorized_Result' application/json: schema: $ref: '#/components/schemas/Unauthorized_Result' examples: example: value: StatusCode: 401 Message: >- Unauthorized: Bearer token is missing, expired, or invalid. Re-authenticate via POST /v1.0/oauth2/tokens. text/json: schema: $ref: '#/components/schemas/Unauthorized_Result' '403': description: Forbidden content: text/plain: schema: $ref: '#/components/schemas/Forbidden_Result' application/json: schema: $ref: '#/components/schemas/Forbidden_Result' examples: example: value: StatusCode: 403 Message: >- Forbidden: your token does not have permission to access this resource. Check the ApiEndpoint scope. text/json: schema: $ref: '#/components/schemas/Forbidden_Result' '404': description: Not Found content: text/plain: schema: $ref: '#/components/schemas/NotFound_Result' application/json: schema: $ref: '#/components/schemas/NotFound_Result' examples: example: value: StatusCode: 404 Message: >- Not found: the requested resource does not exist or belongs to a different account. text/json: schema: $ref: '#/components/schemas/NotFound_Result' '405': description: Method Not Allowed content: text/plain: schema: $ref: '#/components/schemas/MethodNotAllowed_Result' application/json: schema: $ref: '#/components/schemas/MethodNotAllowed_Result' examples: example: value: StatusCode: 405 Message: >- Method not allowed: verify the HTTP method required for this endpoint. text/json: schema: $ref: '#/components/schemas/MethodNotAllowed_Result' '408': description: Request Timeout content: text/plain: schema: $ref: '#/components/schemas/RequestTimeout_Result' application/json: schema: $ref: '#/components/schemas/RequestTimeout_Result' examples: example: value: StatusCode: 408 Message: >- Request timeout: the server did not receive a complete request within the allowed time. Retry with exponential backoff. text/json: schema: $ref: '#/components/schemas/RequestTimeout_Result' '429': description: Too Many Requests content: text/plain: schema: $ref: '#/components/schemas/TooManyRequests_Result' application/json: schema: $ref: '#/components/schemas/TooManyRequests_Result' examples: example: value: StatusCode: 429 Message: >- Too many requests: rate limit exceeded. Slow your request cadence and retry after a short delay. text/json: schema: $ref: '#/components/schemas/TooManyRequests_Result' '500': description: Server Error content: text/plain: schema: $ref: '#/components/schemas/InternalServerError_Result' application/json: schema: $ref: '#/components/schemas/InternalServerError_Result' examples: example: value: StatusCode: 500 Message: >- Internal server error: an unexpected error occurred. If the problem persists contact support@telegent.com. text/json: schema: $ref: '#/components/schemas/InternalServerError_Result' '503': description: Service Unavailable content: text/plain: schema: $ref: '#/components/schemas/ServiceUnavailable_Result' application/json: schema: $ref: '#/components/schemas/ServiceUnavailable_Result' examples: example: value: StatusCode: 503 Message: >- Service unavailable: the API is temporarily unavailable. Retry after a short delay. text/json: schema: $ref: '#/components/schemas/ServiceUnavailable_Result' '504': description: Gateway Timeout content: text/plain: schema: $ref: '#/components/schemas/GatewayTimeout_Result' application/json: schema: $ref: '#/components/schemas/GatewayTimeout_Result' examples: example: value: StatusCode: 504 Message: >- Gateway timeout: an upstream service did not respond in time. Retry with exponential backoff. text/json: schema: $ref: '#/components/schemas/GatewayTimeout_Result' x-codeSamples: - lang: cURL source: >- curl -X GET 'https://api.telegent.com/v1.0/numbers/order?OrderId=JNUOID-10a3g876-....-....-....-c00a36988653' \ -H 'Authorization: Bearer YOUR_TOKEN' components: schemas: BadRequest_Result: required: - StatusCode type: object properties: StatusCode: type: integer format: int32 Message: type: string nullable: true additionalProperties: false Unauthorized_Result: required: - StatusCode type: object properties: StatusCode: type: integer format: int32 Message: type: string nullable: true additionalProperties: false Forbidden_Result: required: - StatusCode type: object properties: StatusCode: type: integer format: int32 Message: type: string nullable: true additionalProperties: false NotFound_Result: required: - StatusCode type: object properties: StatusCode: type: integer format: int32 Message: type: string nullable: true additionalProperties: false MethodNotAllowed_Result: required: - StatusCode type: object properties: StatusCode: type: integer format: int32 Message: type: string nullable: true additionalProperties: false RequestTimeout_Result: required: - StatusCode type: object properties: StatusCode: type: integer format: int32 Message: type: string nullable: true additionalProperties: false TooManyRequests_Result: required: - StatusCode type: object properties: StatusCode: type: integer format: int32 Message: type: string nullable: true additionalProperties: false InternalServerError_Result: required: - StatusCode type: object properties: StatusCode: type: integer format: int32 Message: type: string nullable: true additionalProperties: false ServiceUnavailable_Result: required: - StatusCode type: object properties: StatusCode: type: integer format: int32 Message: type: string nullable: true additionalProperties: false GatewayTimeout_Result: required: - StatusCode type: object properties: StatusCode: type: integer format: int32 Message: type: string nullable: true additionalProperties: false ````