ManagementExperimental

List CDR export targets

Lists the destinations Firsty exports usage session records to. Each target receives the records GET /profiles/{profileReference}/esims/{esimReference}/sessions returns, as one Parquet file per export period, in the configured bucket. To add or change a target, contact Firsty support.

get/management/cdr-export-targets

Authorization

Authorization: Bearer {token} — an OAuth2 access token from the client-credentials flow. How authentication works

Query parameters

limitinteger

Maximum number of items to return (1-100)

Default20

cursorstring

Opaque cursor token for fetching the next page. Pass the nextCursor value from a previous response.

Responses

200List of CDR export targetsapplication/json

Show response body

dataarray of CdrExportTarget

Show properties

cdrExportTargetReferencestring

Identifies the target in GET /management/cdr-export-targets/{cdrExportTargetReference}/deliveries.

namestring

Label set by Firsty when the target was configured.

formatobject

Show properties

typestring

Optionsparquet

compressionstring

Optionssnappy

destinationobject

Show properties

typestring

Optionsgcp_bucket

bucketstring

Google Cloud Storage bucket the files are written to.

authenticationobject

Show properties

typestring

Optionsservice_account_impersonation

serviceAccountstring

Service account Firsty impersonates to write the files.

enabledboolean

Whether export runs are scheduled for this target.

lastExportedAtstring · date-time

End of the most recent period that was exported.

statsobject

Terminal outcomes for export runs created in the last windowDays days.

Show properties

windowDaysinteger

completedinteger

noChangesinteger

Successful runs with no changed usage records to export.

failedinteger

rowsExportedinteger

paginationobject

Show properties

limitinteger

Maximum items per page

hasMoreboolean

Whether there are more items after this page

nextCursorstring | null

Opaque cursor token for the next page. Null when there are no more results.

400Bad request - invalid parameters 401Unauthorized - missing or invalid API key 429Rate limit exceeded. A `429` can also arrive without these headers or this body; handle it by its status code.500Internal server error

Request

curl https://connect.firsty.app/api/v3/management/cdr-export-targets \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

fetch('https://connect.firsty.app/api/v3/management/cdr-export-targets', {
  headers: {
    Authorization: 'Bearer YOUR_ACCESS_TOKEN'
  }
})

requests.get(
    "https://connect.firsty.app/api/v3/management/cdr-export-targets",
    headers={
      "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    }
)

$client = new GuzzleHttp\Client();

$response = $client->request('GET', 'https://connect.firsty.app/api/v3/management/cdr-export-targets', [
  'headers' => [
    'Authorization' => 'Bearer YOUR_ACCESS_TOKEN'
  ]
]);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	requestUrl := "https://connect.firsty.app/api/v3/management/cdr-export-targets"

	req, _ := http.NewRequest("GET", requestUrl, nil)

	req.Header.Add("Authorization", "Bearer YOUR_ACCESS_TOKEN")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://connect.firsty.app/api/v3/management/cdr-export-targets"))
    .header("Authorization", "Bearer YOUR_ACCESS_TOKEN")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

curl https://connect.test.firsty.app/api/v3/management/cdr-export-targets \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

fetch('https://connect.test.firsty.app/api/v3/management/cdr-export-targets', {
  headers: {
    Authorization: 'Bearer YOUR_ACCESS_TOKEN'
  }
})

requests.get(
    "https://connect.test.firsty.app/api/v3/management/cdr-export-targets",
    headers={
      "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    }
)

$client = new GuzzleHttp\Client();

$response = $client->request('GET', 'https://connect.test.firsty.app/api/v3/management/cdr-export-targets', [
  'headers' => [
    'Authorization' => 'Bearer YOUR_ACCESS_TOKEN'
  ]
]);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	requestUrl := "https://connect.test.firsty.app/api/v3/management/cdr-export-targets"

	req, _ := http.NewRequest("GET", requestUrl, nil)

	req.Header.Add("Authorization", "Bearer YOUR_ACCESS_TOKEN")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://connect.test.firsty.app/api/v3/management/cdr-export-targets"))
    .header("Authorization", "Bearer YOUR_ACCESS_TOKEN")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Response

{
  "data": [
    {
      "cdrExportTargetReference": "3F9AB2C1",
      "name": "Data warehouse",
      "format": {
        "type": "parquet",
        "compression": "snappy"
      },
      "destination": {
        "type": "gcp_bucket",
        "bucket": "acme-firsty-cdrs",
        "authentication": {
          "type": "service_account_impersonation",
          "serviceAccount": "firsty-export@acme-data.iam.gserviceaccount.com"
        }
      },
      "enabled": true,
      "lastExportedAt": "2026-01-15T09:30:00Z",
      "stats": {
        "windowDays": 7,
        "completed": 0,
        "noChanges": 0,
        "failed": 0,
        "rowsExported": 0
      }
    }
  ],
  "pagination": {
    "limit": 20,
    "hasMore": true,
    "nextCursor": "MjAyNC0wMS0xNVQxMDowMDowMC4wMDBaOjQy"
  }
}

{
  "type": "https://developers.firsty.app/errors/validation_failed",
  "code": "validation_failed",
  "title": "Validation failed",
  "status": 400,
  "detail": "Request contains invalid fields",
  "errors": [
    {
      "field": "planReference",
      "detail": "Must be a valid 14-character plan reference"
    }
  ]
}