Glossary & Error Codes

Glossary

Term Description
API Application Programming Interface. A set of rules and endpoints that allow applications to interact with a system programmatically.
APN Access Point Name. Defines how a device connects to a mobile data network and which services are available.
Authentication The process of verifying the identity of a client or application calling an API, usually by using tokens or credentials.
Authorization Determines what actions an authenticated client is allowed to perform within an API.
Bandwidth The maximum rate at which data can be transmitted over a network connection.
Catalogue A collection of products that your account has access to within the Developer Portal.
Connectivity The ability of a device or subscription to connect to the mobile network and exchange data.
Endpoint A specific operation within an API, identified by a URL and HTTP method.
Environment The context in which APIs are used, such as production or test.
HTTP Method Defines the type of action performed on an endpoint, such as GET, POST, PUT or DELETE.
ICCID ICCID stands for Integrated Circuit Card Identifier, a unique 18 to 22-digit serial number printed on the back of physical SIM cards or stored within eSIM profiles to identify the SIM hardware globally. It starts with "89" and is essential for activating services, switching carriers, and managing IoT devices.
IMSI International Mobile Subscriber Identity. A unique identifier associated with a SIM, used within the mobile network to identify a subscription.
Latency The time it takes for data to travel from a client to a server and back.
Lifecycle The current state of a subscription or SIM, such as active, suspended or terminated.
MSISDN Mobile Station International Subscriber Directory Number. The phone number of a mobile subscription, usually in international format (for example +31612345678).
Network The mobile infrastructure that provides connectivity for voice, data and messaging services.
OAuth An authorization framework commonly used to obtain access tokens for API calls.
Product A functional grouping of APIs that represent a specific service or capability.
Provisioning The process of activating, modifying or deactivating services on a subscription or SIM.
Rate limit A restriction on the number of API requests that can be made within a given time period.
Request A call made to an API endpoint, including method, headers and optional payload.
Response The data returned by an API endpoint after a request is processed.
Scope Defines the level of access granted to a token when calling an API.
SIM Subscriber Identity Module. Represents a mobile subscription that connects a device to the mobile network.
SIM swap The process of transferring a mobile subscription from one SIM card to another, often used to replace a lost or stolen SIM.
Subscription An agreement that enables access to mobile services such as data, voice or messaging.
Throughput The actual amount of data successfully transmitted over a network in a given time period.
Token A string used to authenticate API requests. Tokens are typically time-limited and must be included with each API call.
Usage Information about how a subscription is used, such as data consumption or activity metrics.
Versioning The practice of managing changes to APIs by exposing different versions over time.
Webhook A mechanism where an API sends data to a client automatically when a specific event occurs.

Error Codes & Troubleshooting

Below is a list of common HTTP error codes and their meanings to help you troubleshoot issues.

Error Code Description Fix?
400 Bad Request - The server could not understand the request due to invalid syntax or missing parameters. Verify the request body and parameters. Make sure all required fields are present and valid.
401 Unauthorized - The client must authenticate itself to get the requested response. Ensure the Access Token is valid and not expired. Re-generate an Access Token if necessary. Double-check client_id and client_secret
403 Forbidden - The client does not have access rights to the content. Check if the resource requires additional permissions
404 Not Found - The server can not find the requested resource. Verify the API endpoint URL and ensure it is correct.
500 Internal Server Error - The server has encountered a situation it doesn't know how to handle. Retry the request later or contact support if the issue persists.
502 Bad Gateway - The server was acting as a gateway or proxy and received an invalid response. Retry the request later or contact support if the issue persists.
503 Service Unavailable - The server is not ready to handle the request. Retry the request later or contact support if the issue persists.
504 Gateway Timeout - The server was acting as a gateway or proxy and did not get a response in time. Retry the request later or contact support if the issue persists.