Observability query API

Query projects, traces, services and releases, manage environment policy, run exports and privacy-request lookups, and read recent signals from a coding agent.

Two separate read surfaces.

APM query API (/v1/apm/*, sk_ server API key, collector hosts). Availability: customer and general capture are not yet available, and an approved proof-of-concept is limited to synthetic, no-personal-data telemetry. At the time of writing a server API key created in the Backoffice cannot carry read:apm, write:apm or read:privacy_request, so those operations are not callable with a self-service key yet; read:export can be selected.

Coding-agent read API (/v1/coding-agent/*, cak_ coding-agent key, on https://ingest.noxtica.com). Create a key under Integrations & API, Coding agent keys.

Credential: ApiKeyAuth, CodingAgentKeyAuth. See Authentication.

List APM projects

GET /v1/apm/projects

Lists tenant-owned observability projects from PostgreSQL authority. Results are cursor-paginated and never cached.

Authentication: Bearer token (ApiKeyAuth), scope read:apm.

Parameters

Responses

Response headers

Response fields (200, application/json)

Response example (200)

{
  "ok": true,
  "items": [
    {
      "project_id": "checkout",
      "display_name": "Checkout",
      "state": "active",
      "region_id": "us-central1",
      "data_plane_id": "primary",
      "capture_enabled": false,
      "enabled_signals": [
        "traces"
      ],
      "authority_epoch": 7,
      "erasure_epoch": 2,
      "created_at": "2026-08-01T00:00:00.000Z",
      "updated_at": "2026-09-01T00:00:00.000Z"
    }
  ],
  "count": 1,
  "truncated": false,
  "next_cursor": null,
  "freshness": "postgres_authority",
  "completeness": "complete"
}

Example request

curl

curl "https://collect.noxtica.com/v1/apm/projects" \
  -H "Authorization: Bearer $NOXTICA_API_KEY"

Node.js (global fetch, Node 18 or later)

const response = await fetch('https://collect.noxtica.com/v1/apm/projects', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.NOXTICA_API_KEY}`,
  },
});
console.log(response.status, await response.text());

Python (standard library)

import os
import urllib.request

request = urllib.request.Request(
    "https://collect.noxtica.com/v1/apm/projects",
    headers={
        "Authorization": f"Bearer {os.environ['NOXTICA_API_KEY']}",
    },
    method="GET",
)
with urllib.request.urlopen(request) as response:
    print(response.status, response.read().decode())

List project environments

GET /v1/apm/projects/{projectId}/environments

Lists environments belonging to one tenant-owned APM project from PostgreSQL authority.

Authentication: Bearer token (ApiKeyAuth), scope read:apm.

Parameters

Responses

Response headers

Response fields (200, application/json)

Response example (200)

{
  "ok": true,
  "project_id": "checkout",
  "items": [
    {
      "project_id": "checkout",
      "environment_id": "prod",
      "display_name": "Production",
      "environment_kind": "production",
      "state": "active",
      "region_id": "us-central1",
      "data_plane_id": "primary",
      "capture_enabled": false,
      "allowed_signals": [
        "traces"
      ],
      "sampling_policy_id": "baseline",
      "retention_policy_version": 3,
      "privacy_policy_version": 2,
      "authority_epoch": 7,
      "erasure_epoch": 2,
      "quota_manifest_revision": 4,
      "parser_manifest_revision": 5,
      "created_at": "2026-08-01T00:00:00.000Z",
      "updated_at": "2026-09-01T00:00:00.000Z"
    }
  ],
  "count": 1,
  "truncated": false,
  "next_cursor": null,
  "freshness": "postgres_authority",
  "completeness": "complete"
}

Example request

curl

curl "https://collect.noxtica.com/v1/apm/projects/example-projectId/environments" \
  -H "Authorization: Bearer $NOXTICA_API_KEY"

Node.js (global fetch, Node 18 or later)

const response = await fetch('https://collect.noxtica.com/v1/apm/projects/example-projectId/environments', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.NOXTICA_API_KEY}`,
  },
});
console.log(response.status, await response.text());

Python (standard library)

import os
import urllib.request

request = urllib.request.Request(
    "https://collect.noxtica.com/v1/apm/projects/example-projectId/environments",
    headers={
        "Authorization": f"Bearer {os.environ['NOXTICA_API_KEY']}",
    },
    method="GET",
)
with urllib.request.urlopen(request) as response:
    print(response.status, response.read().decode())

Read an environment policy

GET /v1/apm/projects/{projectId}/environments/{environmentId}/policy

Returns the authoritative environment policy plus bounded sampling and retention policy inventories.

Authentication: Bearer token (ApiKeyAuth), scope read:apm.

Parameters

Responses

Response headers

Response fields (200, application/json)

Response example (200)

{
  "ok": true,
  "project_id": "checkout",
  "environment_id": "prod",
  "policy": {
    "project_id": "checkout",
    "environment_id": "prod",
    "display_name": "Production",
    "environment_kind": "production",
    "state": "active",
    "region_id": "us-central1",
    "data_plane_id": "primary",
    "capture_enabled": false,
    "allowed_signals": [
      "traces"
    ],
    "sampling_policy_id": "baseline",
    "retention_policy_version": 3,
    "privacy_policy_version": 2,
    "authority_epoch": 7,
    "erasure_epoch": 2,
    "quota_manifest_revision": 4,
    "parser_manifest_revision": 5,
    "created_at": "2026-08-01T00:00:00.000Z",
    "updated_at": "2026-09-01T00:00:00.000Z"
  },
  "sampling_policies": [],
  "sampling_policy_count": 0,
  "sampling_policies_truncated": false,
  "retention_policies": [],
  "retention_policy_count": 0,
  "retention_policies_truncated": false,
  "freshness": {
    "source": "postgres_authority",
    "updated_at": "2026-09-01T00:00:00.000Z"
  },
  "completeness": {
    "sampling_policies": "complete",
    "retention_policies": "complete"
  }
}

Example request

curl

curl "https://collect.noxtica.com/v1/apm/projects/example-projectId/environments/example-environmentId/policy" \
  -H "Authorization: Bearer $NOXTICA_API_KEY"

Node.js (global fetch, Node 18 or later)

const response = await fetch('https://collect.noxtica.com/v1/apm/projects/example-projectId/environments/example-environmentId/policy', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.NOXTICA_API_KEY}`,
  },
});
console.log(response.status, await response.text());

Python (standard library)

import os
import urllib.request

request = urllib.request.Request(
    "https://collect.noxtica.com/v1/apm/projects/example-projectId/environments/example-environmentId/policy",
    headers={
        "Authorization": f"Bearer {os.environ['NOXTICA_API_KEY']}",
    },
    method="GET",
)
with urllib.request.urlopen(request) as response:
    print(response.status, response.read().decode())

Update an environment policy

PUT /v1/apm/projects/{projectId}/environments/{environmentId}/policy

Updates a closed allowlist using optimistic authority-epoch concurrency. While capture rollout is OFF, capture_enabled: true is unavailable and returns 409 capture_unavailable; clients may only leave it absent or set it false.

Authentication: Bearer token (ApiKeyAuth), scope write:apm.

Parameters

Request body

Content type application/json, required.

Responses

Response headers

Response fields (200, application/json)

Response example (200)

{
  "ok": true,
  "project_id": "checkout",
  "environment_id": "prod",
  "policy": {
    "project_id": "checkout",
    "environment_id": "prod",
    "display_name": "Production",
    "environment_kind": "production",
    "state": "active",
    "region_id": "us-central1",
    "data_plane_id": "primary",
    "capture_enabled": false,
    "allowed_signals": [
      "traces"
    ],
    "sampling_policy_id": "baseline",
    "retention_policy_version": 3,
    "privacy_policy_version": 2,
    "authority_epoch": 8,
    "erasure_epoch": 2,
    "quota_manifest_revision": 4,
    "parser_manifest_revision": 5,
    "created_at": "2026-08-01T00:00:00.000Z",
    "updated_at": "2026-09-21T00:00:00.000Z"
  },
  "count": 1,
  "truncated": false,
  "freshness": {
    "source": "postgres_authority",
    "updated_at": "2026-09-21T00:00:00.000Z"
  },
  "completeness": "complete"
}

Example request

curl

curl -X PUT "https://collect.noxtica.com/v1/apm/projects/example-projectId/environments/example-environmentId/policy" \
  -H "Authorization: Bearer $NOXTICA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "expected_authority_epoch": 7,
  "capture_enabled": false,
  "allowed_signals": [
    "traces"
  ],
  "sampling_policy_id": "baseline"
}'

Node.js (global fetch, Node 18 or later)

const response = await fetch('https://collect.noxtica.com/v1/apm/projects/example-projectId/environments/example-environmentId/policy', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.NOXTICA_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    expected_authority_epoch: 7,
    capture_enabled: false,
    allowed_signals: [
      'traces',
    ],
    sampling_policy_id: 'baseline',
  }),
});
console.log(response.status, await response.text());

Python (standard library)

import json
import os
import urllib.request

request = urllib.request.Request(
    "https://collect.noxtica.com/v1/apm/projects/example-projectId/environments/example-environmentId/policy",
    data=json.dumps({
        "expected_authority_epoch": 7,
        "capture_enabled": False,
        "allowed_signals": [
            "traces",
        ],
        "sampling_policy_id": "baseline",
    }).encode(),
    headers={
        "Authorization": f"Bearer {os.environ['NOXTICA_API_KEY']}",
        "Content-Type": "application/json",
    },
    method="PUT",
)
with urllib.request.urlopen(request) as response:
    print(response.status, response.read().decode())

Search traces

GET /v1/apm/traces

Searches the warehouse within one explicit project/environment and a range no longer than 31 days. Rows expose only the query allowlist; completeness and freshness are not inferred.

Authentication: Bearer token (ApiKeyAuth), scope read:apm.

Parameters

Responses

Response headers

Response fields (200, application/json)

Response example (200)

{
  "ok": true,
  "available": true,
  "project_id": "checkout",
  "environment_id": "prod",
  "items": [
    {
      "traceId": "0123456789abcdef0123456789abcdef",
      "startTime": "2026-09-20T12:00:00.000Z",
      "partial": false,
      "completeness": "complete",
      "freshnessWatermark": "2026-09-20T12:01:00.000Z",
      "ingestedAt": "2026-09-20T12:01:01.000Z"
    }
  ],
  "count": 1,
  "truncated": false,
  "next_cursor": null,
  "partial": false,
  "completeness": "complete",
  "freshness": {
    "watermark": "2026-09-20T12:01:00.000Z",
    "ingested_at": "2026-09-20T12:01:01.000Z"
  }
}

Example request

curl

curl "https://collect.noxtica.com/v1/apm/traces?project_id=example-project_id&environment_id=example-environment_id&from=2026-01-01T00%3A00%3A00Z&to=2026-01-01T00%3A00%3A00Z" \
  -H "Authorization: Bearer $NOXTICA_API_KEY"

Node.js (global fetch, Node 18 or later)

const response = await fetch('https://collect.noxtica.com/v1/apm/traces?project_id=example-project_id&environment_id=example-environment_id&from=2026-01-01T00%3A00%3A00Z&to=2026-01-01T00%3A00%3A00Z', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.NOXTICA_API_KEY}`,
  },
});
console.log(response.status, await response.text());

Python (standard library)

import os
import urllib.request

request = urllib.request.Request(
    "https://collect.noxtica.com/v1/apm/traces?project_id=example-project_id&environment_id=example-environment_id&from=2026-01-01T00%3A00%3A00Z&to=2026-01-01T00%3A00%3A00Z",
    headers={
        "Authorization": f"Bearer {os.environ['NOXTICA_API_KEY']}",
    },
    method="GET",
)
with urllib.request.urlopen(request) as response:
    print(response.status, response.read().decode())

Read trace detail

GET /v1/apm/traces/{traceId}

Returns a trace summary and a bounded timeline. Parent-edge completeness is explicitly false in this launch contract.

Authentication: Bearer token (ApiKeyAuth), scope read:apm.

Parameters

Responses

Response headers

Response fields (200, application/json)

Response example (200)

{
  "ok": true,
  "available": true,
  "project_id": "checkout",
  "environment_id": "prod",
  "summary": {
    "traceId": "0123456789abcdef0123456789abcdef",
    "startTime": "2026-09-20T12:00:00.000Z",
    "partial": false,
    "completeness": "complete",
    "freshnessWatermark": "2026-09-20T12:01:00.000Z",
    "ingestedAt": "2026-09-20T12:01:01.000Z"
  },
  "timeline": [
    {
      "traceId": "0123456789abcdef0123456789abcdef",
      "spanId": "aaaaaaaaaaaaaaaa",
      "parentSpanId": "bbbbbbbbbbbbbbbb",
      "completeness": "partial",
      "ingestedAt": "2026-09-20T12:01:01.000Z"
    }
  ],
  "count": 1,
  "truncated": false,
  "partial": true,
  "completeness": {
    "summary": "complete",
    "timeline": "partial"
  },
  "freshness": {
    "watermark": "2026-09-20T12:01:00.000Z",
    "ingested_at": "2026-09-20T12:01:01.000Z"
  },
  "parent_edges_complete": false
}

Example request

curl

curl "https://collect.noxtica.com/v1/apm/traces/example-traceId?project_id=example-project_id&environment_id=example-environment_id&from=2026-01-01T00%3A00%3A00Z&to=2026-01-01T00%3A00%3A00Z" \
  -H "Authorization: Bearer $NOXTICA_API_KEY"

Node.js (global fetch, Node 18 or later)

const response = await fetch('https://collect.noxtica.com/v1/apm/traces/example-traceId?project_id=example-project_id&environment_id=example-environment_id&from=2026-01-01T00%3A00%3A00Z&to=2026-01-01T00%3A00%3A00Z', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.NOXTICA_API_KEY}`,
  },
});
console.log(response.status, await response.text());

Python (standard library)

import os
import urllib.request

request = urllib.request.Request(
    "https://collect.noxtica.com/v1/apm/traces/example-traceId?project_id=example-project_id&environment_id=example-environment_id&from=2026-01-01T00%3A00%3A00Z&to=2026-01-01T00%3A00%3A00Z",
    headers={
        "Authorization": f"Bearer {os.environ['NOXTICA_API_KEY']}",
    },
    method="GET",
)
with urllib.request.urlopen(request) as response:
    print(response.status, response.read().decode())

List service health

GET /v1/apm/services

Returns bounded aggregate health rows for one project/environment and a range no longer than 31 days.

Authentication: Bearer token (ApiKeyAuth), scope read:apm.

Parameters

Responses

Response headers

Response fields (200, application/json)

Response example (200)

{
  "ok": true,
  "available": true,
  "project_id": "checkout",
  "environment_id": "prod",
  "items": [
    {
      "service_name": "checkout-api",
      "trace_count": 120,
      "error_trace_count": 3,
      "error_rate": 0.025,
      "p50_duration_ms": 42,
      "p95_duration_ms": 310,
      "completeness": "unknown",
      "freshness_watermark": "2026-09-20T12:01:00.000Z"
    }
  ],
  "count": 1,
  "truncated": false,
  "partial": false,
  "completeness": "unknown",
  "freshness_watermark": "2026-09-20T12:01:00.000Z"
}

Example request

curl

curl "https://collect.noxtica.com/v1/apm/services?project_id=example-project_id&environment_id=example-environment_id&from=2026-01-01T00%3A00%3A00Z&to=2026-01-01T00%3A00%3A00Z" \
  -H "Authorization: Bearer $NOXTICA_API_KEY"

Node.js (global fetch, Node 18 or later)

const response = await fetch('https://collect.noxtica.com/v1/apm/services?project_id=example-project_id&environment_id=example-environment_id&from=2026-01-01T00%3A00%3A00Z&to=2026-01-01T00%3A00%3A00Z', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.NOXTICA_API_KEY}`,
  },
});
console.log(response.status, await response.text());

Python (standard library)

import os
import urllib.request

request = urllib.request.Request(
    "https://collect.noxtica.com/v1/apm/services?project_id=example-project_id&environment_id=example-environment_id&from=2026-01-01T00%3A00%3A00Z&to=2026-01-01T00%3A00%3A00Z",
    headers={
        "Authorization": f"Bearer {os.environ['NOXTICA_API_KEY']}",
    },
    method="GET",
)
with urllib.request.urlopen(request) as response:
    print(response.status, response.read().decode())

Read service health and dependencies

GET /v1/apm/services/{serviceName}/health

Returns health plus dependency aggregates. Either warehouse subquery may be unavailable; partial, availability booleans, and reason report that honestly.

Authentication: Bearer token (ApiKeyAuth), scope read:apm.

Parameters

Responses

Response headers

Response fields (200, application/json)

Response example (200)

{
  "ok": true,
  "available": true,
  "partial": false,
  "reason": null,
  "project_id": "checkout",
  "environment_id": "prod",
  "service_name": "checkout-api",
  "health": {
    "service_name": "checkout-api",
    "trace_count": 120,
    "error_trace_count": 3,
    "error_rate": 0.025,
    "p50_duration_ms": 42,
    "p95_duration_ms": 310,
    "completeness": "unknown",
    "freshness_watermark": "2026-09-20T12:01:00.000Z"
  },
  "health_available": true,
  "items": [
    {
      "source_service": "checkout-api",
      "target_service": "payments",
      "protocol": "http",
      "request_count": 50,
      "error_count": 1,
      "p50_duration_ms": 25,
      "p95_duration_ms": 80,
      "p99_duration_ms": 140,
      "freshness_watermark": "2026-09-20T12:01:00.000Z"
    }
  ],
  "count": 1,
  "dependencies_available": true,
  "truncated": false,
  "completeness": "unknown",
  "freshness_watermark": "2026-09-20T12:01:00.000Z"
}

Example request

curl

curl "https://collect.noxtica.com/v1/apm/services/example-serviceName/health?project_id=example-project_id&environment_id=example-environment_id&from=2026-01-01T00%3A00%3A00Z&to=2026-01-01T00%3A00%3A00Z" \
  -H "Authorization: Bearer $NOXTICA_API_KEY"

Node.js (global fetch, Node 18 or later)

const response = await fetch('https://collect.noxtica.com/v1/apm/services/example-serviceName/health?project_id=example-project_id&environment_id=example-environment_id&from=2026-01-01T00%3A00%3A00Z&to=2026-01-01T00%3A00%3A00Z', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.NOXTICA_API_KEY}`,
  },
});
console.log(response.status, await response.text());

Python (standard library)

import os
import urllib.request

request = urllib.request.Request(
    "https://collect.noxtica.com/v1/apm/services/example-serviceName/health?project_id=example-project_id&environment_id=example-environment_id&from=2026-01-01T00%3A00%3A00Z&to=2026-01-01T00%3A00%3A00Z",
    headers={
        "Authorization": f"Bearer {os.environ['NOXTICA_API_KEY']}",
    },
    method="GET",
)
with urllib.request.urlopen(request) as response:
    print(response.status, response.read().decode())

Read release health

GET /v1/apm/releases/{releaseId}/health

Returns bounded aggregate health rows for one release within the required project/environment and time range.

Authentication: Bearer token (ApiKeyAuth), scope read:apm.

Parameters

Responses

Response headers

Response fields (200, application/json)

Response example (200)

{
  "ok": true,
  "available": true,
  "project_id": "checkout",
  "environment_id": "prod",
  "release_id": "2026.09.20",
  "items": [
    {
      "release_id": "2026.09.20",
      "build_id": "build-42",
      "trace_count": 100,
      "error_trace_count": 2,
      "error_rate": 0.02,
      "p50_duration_ms": 40,
      "p95_duration_ms": 300,
      "completeness": "unknown",
      "freshness_watermark": "2026-09-20T12:01:00.000Z"
    }
  ],
  "count": 1,
  "truncated": false,
  "partial": false,
  "completeness": "unknown",
  "freshness_watermark": "2026-09-20T12:01:00.000Z"
}

Example request

curl

curl "https://collect.noxtica.com/v1/apm/releases/example-releaseId/health?project_id=example-project_id&environment_id=example-environment_id&from=2026-01-01T00%3A00%3A00Z&to=2026-01-01T00%3A00%3A00Z" \
  -H "Authorization: Bearer $NOXTICA_API_KEY"

Node.js (global fetch, Node 18 or later)

const response = await fetch('https://collect.noxtica.com/v1/apm/releases/example-releaseId/health?project_id=example-project_id&environment_id=example-environment_id&from=2026-01-01T00%3A00%3A00Z&to=2026-01-01T00%3A00%3A00Z', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.NOXTICA_API_KEY}`,
  },
});
console.log(response.status, await response.text());

Python (standard library)

import os
import urllib.request

request = urllib.request.Request(
    "https://collect.noxtica.com/v1/apm/releases/example-releaseId/health?project_id=example-project_id&environment_id=example-environment_id&from=2026-01-01T00%3A00%3A00Z&to=2026-01-01T00%3A00%3A00Z",
    headers={
        "Authorization": f"Bearer {os.environ['NOXTICA_API_KEY']}",
    },
    method="GET",
)
with urllib.request.urlopen(request) as response:
    print(response.status, response.read().decode())

Create an asynchronous APM export

POST /v1/apm/exports

Creates a tenant-scoped manifest for a range no longer than 31 days. This endpoint never returns storage references, credentials, or a download URL.

Authentication: Bearer token (ApiKeyAuth), scope write:apm.

Request body

Content type application/json, required.

Responses

Response headers

Response fields (201, application/json)

Response example (201)

{
  "ok": true,
  "project_id": "checkout",
  "environment_id": "prod",
  "export_manifest_id": "550e8400-e29b-41d4-a716-446655440000",
  "purpose": "incident_review",
  "fact_names": [
    "apm_spans",
    "apm_trace_summaries"
  ],
  "state": "pending",
  "row_count": null,
  "byte_count": null,
  "created_at": "2026-09-21T00:00:00.000Z",
  "expires_at": "2026-09-21T01:00:00.000Z",
  "completed_at": null
}

Example request

curl

curl -X POST "https://collect.noxtica.com/v1/apm/exports" \
  -H "Authorization: Bearer $NOXTICA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "project_id": "checkout",
  "environment_id": "prod",
  "from": "2026-09-20T00:00:00.000Z",
  "to": "2026-09-21T00:00:00.000Z",
  "fact_names": [
    "apm_spans",
    "apm_trace_summaries"
  ],
  "purpose": "incident_review",
  "expires_in_seconds": 3600
}'

Node.js (global fetch, Node 18 or later)

const response = await fetch('https://collect.noxtica.com/v1/apm/exports', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.NOXTICA_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    project_id: 'checkout',
    environment_id: 'prod',
    from: '2026-09-20T00:00:00.000Z',
    to: '2026-09-21T00:00:00.000Z',
    fact_names: [
      'apm_spans',
      'apm_trace_summaries',
    ],
    purpose: 'incident_review',
    expires_in_seconds: 3600,
  }),
});
console.log(response.status, await response.text());

Python (standard library)

import json
import os
import urllib.request

request = urllib.request.Request(
    "https://collect.noxtica.com/v1/apm/exports",
    data=json.dumps({
        "project_id": "checkout",
        "environment_id": "prod",
        "from": "2026-09-20T00:00:00.000Z",
        "to": "2026-09-21T00:00:00.000Z",
        "fact_names": [
            "apm_spans",
            "apm_trace_summaries",
        ],
        "purpose": "incident_review",
        "expires_in_seconds": 3600,
    }).encode(),
    headers={
        "Authorization": f"Bearer {os.environ['NOXTICA_API_KEY']}",
        "Content-Type": "application/json",
    },
    method="POST",
)
with urllib.request.urlopen(request) as response:
    print(response.status, response.read().decode())

Read asynchronous export status

GET /v1/apm/exports/{exportId}

Returns the safe manifest projection and its real asynchronous state; no object reference or signing credential is exposed.

Authentication: Bearer token (ApiKeyAuth), scope read:export.

Parameters

Responses

Response headers

Response fields (200, application/json)

Response example (200)

{
  "ok": true,
  "project_id": "checkout",
  "environment_id": "prod",
  "export_manifest_id": "550e8400-e29b-41d4-a716-446655440000",
  "purpose": "incident_review",
  "fact_names": [
    "apm_spans"
  ],
  "state": "running",
  "row_count": null,
  "byte_count": null,
  "created_at": "2026-09-21T00:00:00.000Z",
  "expires_at": "2026-09-21T01:00:00.000Z",
  "completed_at": null
}

Example request

curl

curl "https://collect.noxtica.com/v1/apm/exports/example-exportId" \
  -H "Authorization: Bearer $NOXTICA_API_KEY"

Node.js (global fetch, Node 18 or later)

const response = await fetch('https://collect.noxtica.com/v1/apm/exports/example-exportId', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.NOXTICA_API_KEY}`,
  },
});
console.log(response.status, await response.text());

Python (standard library)

import os
import urllib.request

request = urllib.request.Request(
    "https://collect.noxtica.com/v1/apm/exports/example-exportId",
    headers={
        "Authorization": f"Bearer {os.environ['NOXTICA_API_KEY']}",
    },
    method="GET",
)
with urllib.request.urlopen(request) as response:
    print(response.status, response.read().decode())

Request an export download grant

POST /v1/apm/exports/{exportId}/download-grant

Reports readiness only. Collector signing authority is intentionally unavailable, so this launch contract never returns a URL, object reference, bearer token, or credential.

Authentication: Bearer token (ApiKeyAuth), scope read:export.

Parameters

Request body

Content type application/json, optional.

Responses

Response headers

Example request

curl

curl -X POST "https://collect.noxtica.com/v1/apm/exports/example-exportId/download-grant" \
  -H "Authorization: Bearer $NOXTICA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "expires_in_seconds": 60
}'

Node.js (global fetch, Node 18 or later)

const response = await fetch('https://collect.noxtica.com/v1/apm/exports/example-exportId/download-grant', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.NOXTICA_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    expires_in_seconds: 60,
  }),
});
console.log(response.status, await response.text());

Python (standard library)

import json
import os
import urllib.request

request = urllib.request.Request(
    "https://collect.noxtica.com/v1/apm/exports/example-exportId/download-grant",
    data=json.dumps({
        "expires_in_seconds": 60,
    }).encode(),
    headers={
        "Authorization": f"Bearer {os.environ['NOXTICA_API_KEY']}",
        "Content-Type": "application/json",
    },
    method="POST",
)
with urllib.request.urlopen(request) as response:
    print(response.status, response.read().decode())

Read subject export status

GET /v1/apm/privacy/subjects/{subjectHandle}/exports/{requestId}

Hashes the opaque subject handle before repository access and returns only the safe export projection. The cleartext handle and its hash are never returned.

Authentication: Bearer token (ApiKeyAuth), scope read:privacy_request.

Parameters

Responses

Response headers

Response fields (200, application/json)

Response example (200)

{
  "ok": true,
  "privacy_request_id": "dsar-42",
  "project_id": "checkout",
  "environment_id": "prod",
  "export_manifest_id": "550e8400-e29b-41d4-a716-446655440000",
  "purpose": "privacy_subject_export",
  "fact_names": [
    "apm_spans"
  ],
  "state": "pending",
  "row_count": null,
  "byte_count": null,
  "created_at": "2026-09-21T00:00:00.000Z",
  "expires_at": "2026-09-21T01:00:00.000Z",
  "completed_at": null
}

Example request

curl

curl "https://collect.noxtica.com/v1/apm/privacy/subjects/example-subjectHandle/exports/example-requestId" \
  -H "Authorization: Bearer $NOXTICA_API_KEY"

Node.js (global fetch, Node 18 or later)

const response = await fetch('https://collect.noxtica.com/v1/apm/privacy/subjects/example-subjectHandle/exports/example-requestId', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.NOXTICA_API_KEY}`,
  },
});
console.log(response.status, await response.text());

Python (standard library)

import os
import urllib.request

request = urllib.request.Request(
    "https://collect.noxtica.com/v1/apm/privacy/subjects/example-subjectHandle/exports/example-requestId",
    headers={
        "Authorization": f"Bearer {os.environ['NOXTICA_API_KEY']}",
    },
    method="GET",
)
with urllib.request.urlopen(request) as response:
    print(response.status, response.read().decode())

Read subject erasure status

GET /v1/apm/privacy/subjects/{subjectHandle}/erasures/{requestId}

Returns aggregate deletion progress only. Subject identifiers, per-store object references, SQL, credentials, and PII are never exposed.

Authentication: Bearer token (ApiKeyAuth), scope read:privacy_request.

Parameters

Responses

Response headers

Response fields (200, application/json)