SIM Swap API HTTP responses

Here are the possible HTTP status codes you can get when using the SIM Swap API:

200

When you get a successful response containing information about the SIM swap event.

{
    "latestSimChange": "2023-07-03T12:27:08.312Z"
}

400

When there are issues, such as invalid arguments in the client request:

{
    "status": 400,
    "code": "INVALID_ARGUMENT",
    "message": "Client specified an invalid argument, request body or query param"
}

401

When there is an authentication issue with the client request:

{
    "status": 401,
    "code": "UNAUTHENTICATED",
    "message": "Request not authenticated due to missing, invalid, or expired credentials"
}

403

When a client does not have the right or enough permissions to access device data:

{
    "status": 403,
    "code": "PERMISSION_DENIED",
    "message": "Client does not have sufficient permissions to perform this action"
}

404

When the resource data cannot be found:

{
    "status": 404,
    "code": "SIM_SWAP.UNKNOWN_PHONE_NUMBER",
    "message": "SIM swap can't be checked because the phone number is unknown"
}

409

When there's a conflict with two requests for the same phone number (MSISDN):

{
    "status": 409,
    "code": "CONFLICT",
    "message": "Another request is created for the same MSISDN"
}

500

For internal server errors, you can contact Network as Code support team.

{
    "status": 500,
    "code": "INTERNAL",
    "message": "Server error"
}

503

Service is unavailable. Typically the server is down. Contact Network as Code support team and check when the service will return.

{
    "status": 503,
    "code": "UNAVAILABLE",
    "message": "Service unavailable"
}

504

The request time has been exceeded. If it happens repeatedly, consider reducing the request complexity. You can also contact Network as Code support team for possible solutions.

{
    "status": 504,
    "code": "TIMEOUT",
    "message": "Request timeout exceeded. Try later."
}

Last updated on May 21, 2024