Register a given batch by BIC

PATCH

https://cdn.emnify.net/api/v1/sim_batch/bic/:bic

Registers the given SIM batch, assigns all SIMs to the organisation, and sets the status of all contained SIMs to the given value.

If the factory_test_mode_allowed flag is set to true on the tariff plan assignment or it is enabled in the tariff plan, the SIM batch can be also registered with an initial status of 4 = Factory Test, thus setting all of the contained SIMs to factory test status. In turn, the activation_date of these SIMs will not be set yet, but when the factory test volume is consumed, the auto activation date is reached or they are patched to Activated state afterwards.

Registers the given SIM batch, assigns all SIMs to the organisation, and sets the status of all contained SIMs to the given value. If the `factory_test_mode_allowed` flag is set to true on the tariff plan assignment or it is enabled in the tariff plan, the SIM batch can be also registered with an initial status of `4 = Factory Test`, thus setting all of the contained SIMs to factory test status. In turn, the `activation_date` of these SIMs will not be set yet, but when the factory test volume is consumed, the auto activation date is reached or they are patched to `Activated` state afterwards.

Authentication

AuthorizationBearer

An auth_token should be provided to authenticate a session.

To obtain an auth_token, see the /api/v1/authenticate POST request.

Path parameters

bicstringRequiredformat: "%23[0-9A-Z]{15}|[0-9A-Z]{16}"

The BIC of the SIM batch. Leading hash symbols must be URL encoded (%23).

Request

This endpoint expects an object.

sim_statusobjectOptional

Response

Batch successfully registered and assigned all SIMS

simlist of objects

Errors

422

Unprocessable Entity Error

$	curl -X PATCH https://cdn.emnify.net/api/v1/sim_batch/bic/12345678ABCDEFGH \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"sim_status": {
>	"id": 1
>	}
>	}'

1	{
2	"sim": [
3	{
4	"id": 1599276,
5	"iccid": "8988303000000583545"
6	},
7	{
8	"id": 1599277,
9	"iccid": "8988303000000583546"
10	},
11	{
12	"id": 1599278,
13	"iccid": "8988303000000583547"
14	},
15	{
16	"id": 1599279,
17	"iccid": "8988303000000583548"
18	},
19	{
20	"id": 1599280,
21	"iccid": "8988303000000583549"
22	}
23	]
24	}