CDRs will be delivered to an SFTP folder approximately every 10 minutes.
PLEASE NOTE: CDRs can be delayed from upstream provider for multiple reasons and can be delivered, in rare cases, days late. We will always process CDRs as soon as they are received.
You can upload your public key to access the SFTP folder in the settings on the eSIM Go Portal.
- Located at the top of the menu bar click on the "Settings" cog button ⚙
- Click "SFTP Access"
3. Add your public key
4. Copy the command which you can paste now to your terminal to set up SFTP connection
CDR Format
CDRs will be delivered in a JSON format using the following schema:
| Field Name | Format | Notes |
| apn | string | APN used by eSIM |
| bundleId | integer | Bundle ID |
| callCategory | string | Type of call (voice, SMS, data, etc.) |
| callDirection | string | Call direction: MO (Mobile Originated) or MT (Mobile Terminated) |
| calledPartyId | string | Number or ID of the party being called |
| calledPartyLocation | string | Location of the called party during the call |
| callingPartyId | string | Number or ID of the calling party |
| callingPartyLocale | string | Country location of party generating CDR derived from 'mccMnc' |
| callingPartyLocation | string | TADIG Unique operator code |
| callTypeCode | string | Type of consumption ‘voice’, ‘SMS’, ‘MMS’, ‘data’ |
| cdrId | string | The UUID of the CDR |
| cdrBillingDate | string | Date of CDR for billing purposes |
| endTime | string | Time period of CDR UTC |
| entitlementEndDate | string | Bundle End Date |
| entitlementName | string | Bundle Moniker |
| entitlementStartDate | string | Bundle Start Date |
| iccid | string | eSIM ICCID reference |
| mccMnc | string | Network used to generate CDR |
| operatorName | string | Mobile Operator profile |
| partialCdr | boolean | If this is a partial CDR (I.e. part of a sequence) |
| ratType | integer | Indicates the Radio Access Type - see https://itecspec.com/spec/3gpp-29-274-8-17-rat-type/ |
| recordSequenceNumber | integer | Sequence number for partial CDRs |
| startTime | string | Time period of CDR UTC |
| unitOfMeasure | string | Units of measure for consumption ‘seconds’, ‘SMS’, ‘MMS’, ‘bytes’ |
| units | integer | Number of units consumed |
Example of CDR in JSON format
{
"records": [
{
"apn": "uk.data.esim",
"bundleId": 123456789,
"callCategory": "Data National",
"callDirection": "N/A",
"callTypeCode": "Data",
"calledPartyId": "uk.data.esim",
"calledPartyLocation": "N/A",
"callingPartyId": 447123456789,
"callingPartyLocale": "GB",
"callingPartyLocation": "GBRVF",
"cdrBillingDate": "2025-07-19 14:05:35.000",
"cdrId": "50dc3f0a-8c96-47e7-8b7f-3b95802a2807",
"endTime": "2025-07-19 13:11:10.000",
"entitlementEndDate": "2025-08-10 20:09:03.000",
"entitlementName": "domp_ULGB_ULSMS_ULMIN_1M_V1",
"entitlementStartDate": "2025-07-10 19:27:43.000",
"iccid": 89441000400500012345,
"mccMnc": 23415,
"operatorName": "Profile 6",
"partialCdr": false,
"ratType": 6,
"recordSequenceNumber": 10,
"startTime": "2025-07-19 13:11:10.000",
"unitOfMeasure": "Bytes",
"units": 81451
},
{
"apn": "N/A",
"bundleId": 123456789,
"callCategory": "SMS National MO",
"callDirection": "MO",
"callTypeCode": "SMS",
"calledPartyId": "61234",
"calledPartyLocation": "GB",
"callingPartyId": 447123456789,
"callingPartyLocale": "GB",
"callingPartyLocation": "GBRVF",
"cdrBillingDate": "2025-07-16 11:40:35.000",
"cdrId": "502717f9-8a8b-4ce7-88fc-160fc82cc930",
"endTime": "2025-07-16 11:36:52.000",
"entitlementEndDate": "2025-07-16 13:15:30.000",
"entitlementName": "test_1GB_10SMS_10MIN_1D_GB",
"entitlementStartDate": "2025-07-15 13:15:30.000",
"iccid": 89441000400500012345,
"mccMnc": 23415,
"operatorName": "Profile 6",
"partialCdr": false,
"ratType": 0,
"recordSequenceNumber": 4,
"startTime": "2025-07-16 11:36:52.000",
"unitOfMeasure": "SMS",
"units": 1
},
{
"apn": "N/A",
"bundleId": 123456789,
"callCategory": "Voice National MO",
"callDirection": "MO",
"callTypeCode": "Voice",
"calledPartyId": "447123456777",
"calledPartyLocation": "GBRVF",
"callingPartyId": 447123456789,
"callingPartyLocale": "GB",
"callingPartyLocation": "GBRVF",
"cdrBillingDate": "2025-07-15 08:30:35.000",
"cdrId": "a4c7e1a3-6f56-4d55-adbd-89c2af0db084",
"endTime": "2025-07-15 08:24:27.000",
"entitlementEndDate": "2025-08-15 08:03:44.000",
"entitlementName": "domp_20GB_ULSMS_ULMIN_1M_V1",
"entitlementStartDate": "2025-07-14 16:21:27.000",
"iccid": 89441000400500012345,
"mccMnc": 23415,
"operatorName": "Profile 6",
"partialCdr": false,
"ratType": 0,
"recordSequenceNumber": 1,
"startTime": "2025-07-15 08:23:07.000",
"unitOfMeasure": "Seconds",
"units": 75
}
]
}