Management

List CDR export targets

Experimental. This endpoint is still settling — its request and response shape may change without a deprecation cycle.

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 CdrExportTargetrequired

Show properties

cdrExportTargetReferencestringrequired

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

namestringrequired

Label set by Firsty when the target was configured.

formatobjectrequired

Show properties

typestringrequired

Optionsparquet

compressionstringrequired

Optionssnappy

destinationobjectrequired

Show properties

typestringrequired

Optionsgcp_bucket

bucketstringrequired

Google Cloud Storage bucket the files are written to.

authenticationobjectrequired

Show properties

typestringrequired

Optionsservice_account_impersonation

serviceAccountstringrequired

Service account Firsty impersonates to write the files.

enabledbooleanrequired

Whether export runs are scheduled for this target.

lastExportedAtstring · date-timerequired

End of the most recent period that was exported.

statsobjectrequired

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

Show properties

windowDaysintegerrequired

completedintegerrequired

noChangesintegerrequired

Successful runs with no changed rows.

failedintegerrequired

rowsExportedintegerrequired

paginationobjectrequired

Show properties

limitintegerrequired

Maximum items per page

hasMorebooleanrequired

Whether there are more items after this page

nextCursorstring | nullrequired

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 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",
  "title": "Validation failed",
  "status": 400,
  "detail": "Request contains invalid fields",
  "errors": [
    {
      "field": "planReference",
      "detail": "Must be a valid 14-character plan reference"
    }
  ]
}