---
search:
  tags:
    - documents
    - GET
seo:
  description: >-
    Export permission-filtered document metadata CSV (scope documents:read).
    Reference for the GET /api/v1/documents/export endpoint in the Basenet
    Public API.
sidebar:
  label: Export permission-filtered document metadata CSV (scope documents:read)
  badge: GET
title: Export permission-filtered document metadata CSV (scope documents:read)
type: openapi-operation
---
Endpoint: `GET /api/v1/documents/export`

Authentication: `bearerAuth` (Scoped API token (bnx\_…). Required scopes are noted per operation.)

Parameters:
- `relationId` (in query, string, optional)

Responses:
- `200`: CSV metadata export (capped with total/truncated response headers)
- `401`: Unauthenticated
- `403`: Forbidden (missing scope or permission)
- `429`: Rate limited

Response 200 body (`text/csv`): string