# Seamless Developer Portal

> Become Seamless. Launch, upgrade or turn into a mobile operator. Whoever you are, at Telness Tech we empower you to become seamless. Playfully easy, infinitely scalable, as telecom should be.

## Docs

- [Start email login](https://docs.telnesstech.com/api-reference/auth/start-email-login.md): Initiates an email-based login flow by sending a verification code to the provided email address.
- [Verify email login](https://docs.telnesstech.com/api-reference/auth/verify-email-login.md): Verifies an email login by validating the verification code sent to the email address.
- [Authentication](https://docs.telnesstech.com/api-reference/authentication.md): API keys, user tokens, and security best practices for accessing the SeamlessOS API.
- [Choose Your Integration](https://docs.telnesstech.com/api-reference/choose-your-integration.md): Select the SeamlessOS API integration style that best fits your business model and technical ownership
- [Conventions](https://docs.telnesstech.com/api-reference/conventions.md): Design principles and naming patterns that make the SeamlessOS API consistent and predictable.
- [Custom workflow triggered](https://docs.telnesstech.com/api-reference/custom/custom-workflow-triggered.md): Sent from within a workflow and content is defined by the workflow configuration.
- [Create customer](https://docs.telnesstech.com/api-reference/customers/create-customer.md): Create a new customer.
- [Customer created](https://docs.telnesstech.com/api-reference/customers/customer-created.md): Sent when a new customer is created in the system.
- [Customer deleted](https://docs.telnesstech.com/api-reference/customers/customer-deleted.md): Sent when a customer account is permanently deleted from the system.
- [Customer updated](https://docs.telnesstech.com/api-reference/customers/customer-updated.md): Sent when customer information is modified, including profile changes, billing updates, or status changes.
- [Get customer](https://docs.telnesstech.com/api-reference/customers/get-customer.md): Get a customer by ID or referenceId.
- [Get customer product catalog](https://docs.telnesstech.com/api-reference/customers/get-customer-product-catalog.md): Get the customer's product catalog, this is a combination of the default product catalog configured in the system and other product catalogs assigned to the customer.
- [List customers](https://docs.telnesstech.com/api-reference/customers/list-customers.md): List all customers.
- [Remove user from customer](https://docs.telnesstech.com/api-reference/customers/remove-user-from-customer.md): Remove a user from a customer.
- [Update customer](https://docs.telnesstech.com/api-reference/customers/update-customer.md): Update an existing customer.
- [Errors](https://docs.telnesstech.com/api-reference/errors.md): Understanding error responses and how to handle them in the SeamlessOS API.
- [Get started](https://docs.telnesstech.com/api-reference/get-started.md): Get your first order with the SeamlessOS API in minutes
- [Idempotency](https://docs.telnesstech.com/api-reference/idempotency.md): Safely retry requests without creating duplicate operations using idempotency keys.
- [API Reference](https://docs.telnesstech.com/api-reference/index.md): Complete API documentation for the SeamlessOS platform - billing, subscriptions, payments, and telecommunications services
- [Get SIM details](https://docs.telnesstech.com/api-reference/inventory/get-sim-details.md): Retrieve details of a SIM card from inventory by its ICCID.
- [Lease phone numbers](https://docs.telnesstech.com/api-reference/inventory/lease-phone-numbers.md): Reserve phone numbers from inventory for use in orders. This allows customers to choose specific numbers before completing their order.
- [Get invoice](https://docs.telnesstech.com/api-reference/invoices/get-invoice.md): Retrieve details of a specific invoice by its identifier, including status, due date, and payment information.
- [List invoices](https://docs.telnesstech.com/api-reference/invoices/list-invoices.md): Retrieve a paginated list of invoices with optional filtering by status, customer, or date range.
- [Mark invoice as paid](https://docs.telnesstech.com/api-reference/invoices/mark-invoice-as-paid.md): Mark an invoice as paid when you manage your own payment processing.
- [Cancel license](https://docs.telnesstech.com/api-reference/licenses/cancel-license.md): Cancel a license.
- [Change license product offering](https://docs.telnesstech.com/api-reference/licenses/change-license-product-offering.md): Change the product offering of a license (upgrade or downgrade).
- [Create license](https://docs.telnesstech.com/api-reference/licenses/create-license.md): Create a new license
- [Get license](https://docs.telnesstech.com/api-reference/licenses/get-license.md): Retrieve detailed information about a specific license using its unique identifier.
- [Get product offering options for license](https://docs.telnesstech.com/api-reference/licenses/get-product-offering-options-for-license.md): Get all available product offerings a license can be changed to and when the change can take effect.
- [License activated](https://docs.telnesstech.com/api-reference/licenses/license-activated.md): Sent when a license becomes ACTIVE.
- [License cancelled](https://docs.telnesstech.com/api-reference/licenses/license-cancelled.md): Sent when a license cancellation is confirmed.
- [License created](https://docs.telnesstech.com/api-reference/licenses/license-created.md): Sent when a license is created.
- [License ended](https://docs.telnesstech.com/api-reference/licenses/license-ended.md): Sent when a license reaches final end state.
- [License renewed](https://docs.telnesstech.com/api-reference/licenses/license-renewed.md): Sent when a license renews into a new term/period.
- [License updated](https://docs.telnesstech.com/api-reference/licenses/license-updated.md): Sent when a license changes.
- [List licenses](https://docs.telnesstech.com/api-reference/licenses/list-licenses.md): List all licenses.
- [Orders & Payments](https://docs.telnesstech.com/api-reference/orders-and-payments.md): Integrate payment collection with orders using your own payment provider or managed payment sessions
- [Add line item](https://docs.telnesstech.com/api-reference/orders/add-line-item.md): Add a new line item to an order. Order must be in PENDING status.
- [Approve order](https://docs.telnesstech.com/api-reference/orders/approve-order.md): Approve an order that requires admin or manager approval. Only orders in PENDING_APPROVAL status can be approved. The approving user must have the appropriate role for the approval type required by the order.
- [Calculate order price](https://docs.telnesstech.com/api-reference/orders/calculate-order-price.md): Calculate the total price for an order including taxes, fees, and discounts.
- [Cancel order](https://docs.telnesstech.com/api-reference/orders/cancel-order.md): Cancel an order before it has been submitted. Only orders in PENDING status can be cancelled. This prevents the order from being submitted and cleans up any reserved resources.
- [Create order](https://docs.telnesstech.com/api-reference/orders/create-order.md): Create a new order with initial configuration. Orders can be created with minimal information and progressively configured.
- [Get order](https://docs.telnesstech.com/api-reference/orders/get-order.md): Retrieve a specific order by ID with all line items and current status.
- [List orders](https://docs.telnesstech.com/api-reference/orders/list-orders.md): List orders with optional filtering and pagination.
- [Order cancelled](https://docs.telnesstech.com/api-reference/orders/order-cancelled.md): Sent when an order is cancelled.
- [Order created](https://docs.telnesstech.com/api-reference/orders/order-created.md): Sent when an order is created.
- [Order expired](https://docs.telnesstech.com/api-reference/orders/order-expired.md): Sent when an order expires before completion.
- [Order status changed](https://docs.telnesstech.com/api-reference/orders/order-status-changed.md): Sent when an order status transitions (e.g. PENDING -> SUBMITTED, PROCESSING -> COMPLETED, etc.).
- [Order submitted](https://docs.telnesstech.com/api-reference/orders/order-submitted.md): Sent when an order is formally submitted for processing/fulfillment.
- [Order updated](https://docs.telnesstech.com/api-reference/orders/order-updated.md): Sent when an order changes (line items, metadata, pricing recalculation).
- [Remove line item](https://docs.telnesstech.com/api-reference/orders/remove-line-item.md): Remove a line item from an order. Order must be in PENDING status.
- [Submit order](https://docs.telnesstech.com/api-reference/orders/submit-order.md): Submit an order for fulfillment. Requires payment, signing, or card capture, depending on the setup.
- [Update line item](https://docs.telnesstech.com/api-reference/orders/update-line-item.md): Update a line item configuration. Order must be in PENDING status.
- [Update order](https://docs.telnesstech.com/api-reference/orders/update-order.md): Update order details (excluding line items). Order must be in PENDING status.
- [Cancel payment link](https://docs.telnesstech.com/api-reference/payment-links/cancel-payment-link.md): Cancel an active payment link, preventing further payment attempts through the link.
- [Create payment link](https://docs.telnesstech.com/api-reference/payment-links/create-payment-link.md): Create a new payment link that can be shared with customers to collect payments.
- [Get payment link](https://docs.telnesstech.com/api-reference/payment-links/get-payment-link.md): Retrieve details of a specific payment link.
- [List payment links](https://docs.telnesstech.com/api-reference/payment-links/list-payment-links.md): Get a list of payment links.
- [Cancel payment profile session](https://docs.telnesstech.com/api-reference/payment-profile-sessions/cancel-payment-profile-session.md): Cancel an active payment profile session, preventing further setup attempts.
- [Create payment profile session](https://docs.telnesstech.com/api-reference/payment-profile-sessions/create-payment-profile-session.md): Create a new payment profile session to set up and save a payment method for future use.
- [Get payment profile session](https://docs.telnesstech.com/api-reference/payment-profile-sessions/get-payment-profile-session.md): Retrieve details of a specific payment profile session by its identifier.
- [Delete payment profile](https://docs.telnesstech.com/api-reference/payment-profiles/delete-payment-profile.md): Remove a saved payment method permanently. This action cannot be undone and will prevent future use of this payment profile.
- [Get payment profile](https://docs.telnesstech.com/api-reference/payment-profiles/get-payment-profile.md): Retrieve details of a specific saved payment method by its identifier.
- [List payment profiles for customer](https://docs.telnesstech.com/api-reference/payment-profiles/list-payment-profiles-for-customer.md): List saved payment profiles for the customer.
- [Cancel payment session](https://docs.telnesstech.com/api-reference/payment-sessions/cancel-payment-session.md): Cancel an active payment session, preventing further payment attempts.
- [Create payment session](https://docs.telnesstech.com/api-reference/payment-sessions/create-payment-session.md): Create a new payment session to collect payment information for an order. For orders with a positive total, this initiates payment collection. For zero-total orders, consider creating a payment profile session instead.
- [Get payment session](https://docs.telnesstech.com/api-reference/payment-sessions/get-payment-session.md): Retrieve details of a specific payment session by its identifier.
- [Get payment](https://docs.telnesstech.com/api-reference/payments/get-payment.md): Get a payment by ID
- [List payments](https://docs.telnesstech.com/api-reference/payments/list-payments.md): Retrieve a paginated list of payments with optional filtering by status, customer, or date range.
- [List product catalogs](https://docs.telnesstech.com/api-reference/product-catalogs/list-product-catalogs.md): List all product catalogs with optional text search filtering and pagination.
- [Get promotion by code](https://docs.telnesstech.com/api-reference/product-discounts/get-promotion-by-code.md): Look up a promotion by its promotional code to check availability and details.
- [Get product offering](https://docs.telnesstech.com/api-reference/product-offerings/get-product-offering.md): Get a product offering by ID.
- [List product offerings](https://docs.telnesstech.com/api-reference/product-offerings/list-product-offerings.md): List all product offerings available to the customer.
- [List Travel eSIM countries](https://docs.telnesstech.com/api-reference/product-offerings/list-travel-esim-countries.md): List all countries and regions available across travel eSIM product offerings.
- [Rate Limiting](https://docs.telnesstech.com/api-reference/rate-limiting.md): Understanding rate limits and how to build resilient integrations.
- [Cancel signing session](https://docs.telnesstech.com/api-reference/signing-sessions/cancel-signing-session.md): Cancel an active signing session.
- [Create signing session](https://docs.telnesstech.com/api-reference/signing-sessions/create-signing-session.md): Create a new contract signing session for an order that requires legal signature.
- [Get signing session](https://docs.telnesstech.com/api-reference/signing-sessions/get-signing-session.md): Retrieve the details and current status of a specific signing session.
- [List signing providers](https://docs.telnesstech.com/api-reference/signing-sessions/list-signing-providers.md): Retrieve available signing providers and their requirements for signer details.
- [List signing sessions](https://docs.telnesstech.com/api-reference/signing-sessions/list-signing-sessions.md): Retrieve a list of signing sessions with optional filtering by order or status.
- [Get subscriber](https://docs.telnesstech.com/api-reference/subscribers/get-subscriber.md): Retrieve detailed information about a specific subscriber using its unique identifier.
- [List subscribers](https://docs.telnesstech.com/api-reference/subscribers/list-subscribers.md): List all subscribers.
- [Update subscriber](https://docs.telnesstech.com/api-reference/subscribers/update-subscriber.md): Update the details of an existing subscriber.
- [Add subscription add-on](https://docs.telnesstech.com/api-reference/subscription-addons/add-subscription-add-on.md): Add an add-on to a subscription.
- [Cancel subscription add-on](https://docs.telnesstech.com/api-reference/subscription-addons/cancel-subscription-add-on.md): Cancel an add-on on a subscription.
- [Change subscription add-on product offering](https://docs.telnesstech.com/api-reference/subscription-addons/change-subscription-add-on-product-offering.md): Change an existing add-on to a different product offering (upgrade or downgrade).
- [Get change options for subscription add-on](https://docs.telnesstech.com/api-reference/subscription-addons/get-change-options-for-subscription-add-on.md): Get all available product offerings an existing add-on can be changed to and when the change can take effect.
- [List active add-ons for subscription](https://docs.telnesstech.com/api-reference/subscription-addons/list-active-add-ons-for-subscription.md): Get all active and pending add-ons for a subscription.
- [Subscription port in completed](https://docs.telnesstech.com/api-reference/subscription-port-in/subscription-port-in-completed.md): Sent when the number porting completes successfully.
- [Subscription port in failed](https://docs.telnesstech.com/api-reference/subscription-port-in/subscription-port-in-failed.md): Sent when a number port-in attempt fails irrecoverably or requires manual intervention.
- [Subscription port in initiated](https://docs.telnesstech.com/api-reference/subscription-port-in/subscription-port-in-initiated.md): Sent when a port-in request is created for a subscription.
- [Subscription port in updated](https://docs.telnesstech.com/api-reference/subscription-port-in/subscription-port-in-updated.md): Sent when port-in details (schedule, status) change.
- [Get subscription usage](https://docs.telnesstech.com/api-reference/subscription-usage/get-subscription-usage.md): Retrieve the current period's usage for a subscription.
- [Get usage for multiple subscriptions](https://docs.telnesstech.com/api-reference/subscription-usage/get-usage-for-multiple-subscriptions.md): Retrieve current usage statistics for multiple subscriptions by providing their IDs.
- [Subscription quota threshold exceeded](https://docs.telnesstech.com/api-reference/subscription-usage/subscription-quota-threshold-exceeded.md): Sent when a subscription quota threshold is exceeded (e.g. 80%, 100% of data, SMS, or voice allowance).
- [Activate subscription](https://docs.telnesstech.com/api-reference/subscriptions/activate-subscription.md): Activate a pending subscription by providing the necessary network activation details.
- [Cancel subscription](https://docs.telnesstech.com/api-reference/subscriptions/cancel-subscription.md): This endpoint allows cancelling a subscription with various timing options: - Next day cancellation - Beginning of next month cancellation - Specific date cancellation
- [Change subscription product offering](https://docs.telnesstech.com/api-reference/subscriptions/change-subscription-product-offering.md): Change the product offering of a subscription (upgrade or downgrade).
- [Change subscription SIM card](https://docs.telnesstech.com/api-reference/subscriptions/change-subscription-sim-card.md): Change the SIM card (ICC/ICCID) for a subscription. This is used when replacing a lost, damaged, or upgraded SIM card.
- [Create subscription](https://docs.telnesstech.com/api-reference/subscriptions/create-subscription.md): Create a new subscription for a customer.
- [Get change options for subscription](https://docs.telnesstech.com/api-reference/subscriptions/get-change-options-for-subscription.md): Get all available product offerings a subscription can be changed to and when the change can take effect.
- [Get eSIM QR code](https://docs.telnesstech.com/api-reference/subscriptions/get-esim-qr-code.md): Retrieve QR code data and hosted URL for eSIM profile download.
- [Get subscription](https://docs.telnesstech.com/api-reference/subscriptions/get-subscription.md): Retrieve detailed information about a specific subscription using its unique identifier.
- [Get subscription in-porting](https://docs.telnesstech.com/api-reference/subscriptions/get-subscription-in-porting.md): Retrieve the current porting information for a subscription that is in the process of porting in a number.
- [List subscriptions](https://docs.telnesstech.com/api-reference/subscriptions/list-subscriptions.md): List all subscriptions.
- [Pause subscription](https://docs.telnesstech.com/api-reference/subscriptions/pause-subscription.md): Pause a subscription. The customer stops paying and service is disabled. This is typically used when a customer wants to temporarily stop service.
- [Restore subscription](https://docs.telnesstech.com/api-reference/subscriptions/restore-subscription.md): Restore a suspended, paused, or blocked subscription back to active state.
- [Subscription activated](https://docs.telnesstech.com/api-reference/subscriptions/subscription-activated.md): Sent when a subscription enters ACTIVE state.
- [Subscription cancelled](https://docs.telnesstech.com/api-reference/subscriptions/subscription-cancelled.md): Sent when a subscription cancellation is confirmed (end-of-term or immediate as applicable).
- [Subscription created](https://docs.telnesstech.com/api-reference/subscriptions/subscription-created.md): Sent when a new subscription has been successfully created.
- [Subscription ended](https://docs.telnesstech.com/api-reference/subscriptions/subscription-ended.md): Sent when a subscription reaches its final end (no longer billable / usable).
- [Subscription renewed](https://docs.telnesstech.com/api-reference/subscriptions/subscription-renewed.md): Sent when a subscription successfully renews into a new billing period/term.
- [Subscription subscriber set](https://docs.telnesstech.com/api-reference/subscriptions/subscription-subscriber-set.md): Sent when a subscriber is assigned to a subscription.
- [Subscription updated](https://docs.telnesstech.com/api-reference/subscriptions/subscription-updated.md): Sent when mutable fields on an existing subscription are changed (e.g. status transition, product offering change, MSISDN assignment, metadata updates).
- [Suspend subscription](https://docs.telnesstech.com/api-reference/subscriptions/suspend-subscription.md): Temporarily suspend a subscription. The customer continues to pay but service is disabled. This is typically used for payment issues or fraud prevention.
- [Update subscription porting details](https://docs.telnesstech.com/api-reference/subscriptions/update-subscription-porting-details.md): Update the porting details for a subscription that is in the process of porting in a number. This endpoint allows you to modify porting information while the port is still pending or in progress.
- [Calculate taxes](https://docs.telnesstech.com/api-reference/taxes/calculate-taxes.md): Calculate taxes for line items at a specific address.
- [Check network coverage](https://docs.telnesstech.com/api-reference/tools/check-network-coverage.md): Check network coverage quality and availability for a specific address.
- [Check number porting eligibility](https://docs.telnesstech.com/api-reference/tools/check-number-porting-eligibility.md): Check if a phone number is eligible for porting to this network.
- [Get device information by IMEI](https://docs.telnesstech.com/api-reference/tools/get-device-information-by-imei.md): Get detailed information about a device using its IMEI number.
- [Validate address](https://docs.telnesstech.com/api-reference/tools/validate-address.md): Validate an address and get suggestions for corrections if the address is invalid.
- [Travel eSIM](https://docs.telnesstech.com/api-reference/travel-esim.md): Integrate Travel eSIM products for international data connectivity
- [Create user](https://docs.telnesstech.com/api-reference/users/create-user.md): Create a new user.
- [Get user](https://docs.telnesstech.com/api-reference/users/get-user.md): Get a user by ID or referenceId.
- [List users](https://docs.telnesstech.com/api-reference/users/list-users.md): List all users.
- [Update user](https://docs.telnesstech.com/api-reference/users/update-user.md): Update an existing user.
- [Webhooks](https://docs.telnesstech.com/api-reference/webhooks.md): Real-time notifications for subscription, billing, payment, and usage events with reliable delivery and simple integration.
- [Trigger workflow via webhook](https://docs.telnesstech.com/api-reference/workflows/trigger-workflow-via-webhook.md): Trigger a registered workflow via webhook. The wildcard path is matched against registered workflow webhook paths.
- [Seamless Developer Portal](https://docs.telnesstech.com/index.md)

## OpenAPI Specs

- [bundled_openapi](https://docs.telnesstech.com/api-reference/bundled_openapi.json)
- [openapi](https://docs.telnesstech.com/api-reference/openapi.json)