Management

List CDR export deliveries

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

Lists the export runs of one target over the last 7 days, newest first. A run covers one period and ends completed with a file at destinationPath, no_changes when the period held no records, or failed.

get/management/cdr-export-targets/{cdrExportTargetReference}/deliveries

Authorization

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

Path parameters

cdrExportTargetReferencestringrequired

CDR export target reference, as returned by GET /management/cdr-export-targets.

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 export deliveriesapplication/json

Show response body

dataarray of CdrExportDeliveryrequired

Show properties

periodFromstring · date-timerequired

Start of the period this run covers.

periodTostring · date-timerequired

End of the period this run covers.

statusstringrequired

preparing and pending are in flight, retrying will run again at nextAttemptAt, completed wrote a file to destinationPath, no_changes found no records for the period and wrote nothing, failed gave up.

Optionspreparingpendingretryingcompletedno_changesfailed

destinationPathstring | nullrequired

Object path of the written file in the bucket. Null until the run completes.

rowCountinteger | nullrequired

Records in the written file.

objectSizeBytesinteger | nullrequired

crc32cstring | nullrequired

Base64 CRC32C checksum of the written file, as Google Cloud Storage reports it.

attemptCountintegerrequired

nextAttemptAtstring | null · date-timerequired

lastAttemptedAtstring | null · date-timerequired

completedAtstring | null · date-timerequired

createdAtstring · date-timerequired

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 404Resource not found 429Rate limit exceeded 500Internal server error

Request

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

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

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

$client = new GuzzleHttp\Client();

$response = $client->request('GET', 'https://connect.firsty.app/api/v3/management/cdr-export-targets/{cdrExportTargetReference}/deliveries', [
  '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/{cdrExportTargetReference}/deliveries"

	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/{cdrExportTargetReference}/deliveries"))
    .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/{cdrExportTargetReference}/deliveries' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

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

requests.get(
    "https://connect.test.firsty.app/api/v3/management/cdr-export-targets/{cdrExportTargetReference}/deliveries",
    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/{cdrExportTargetReference}/deliveries', [
  '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/{cdrExportTargetReference}/deliveries"

	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/{cdrExportTargetReference}/deliveries"))
    .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": [
    {
      "periodFrom": "2026-01-15T09:30:00Z",
      "periodTo": "2026-01-15T09:30:00Z",
      "status": "completed",
      "destinationPath": "firsty/cdr/2026/09/16/usage-sessions-2026-09-16T10-00-00Z.parquet",
      "rowCount": 18234,
      "objectSizeBytes": 2097152,
      "crc32c": "AAAAAA==",
      "attemptCount": 1,
      "nextAttemptAt": "2026-01-15T09:30:00Z",
      "lastAttemptedAt": "2026-01-15T09:30:00Z",
      "completedAt": "2026-01-15T09:30:00Z",
      "createdAt": "2026-01-15T09:30:00Z"
    }
  ],
  "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"
    }
  ]
}