Skip to main content

Step 1: Make Your First API Call

Let’s retrieve all recordings in your workspace using a GET request:
curl -X GET "https://{your-subdomain}.neetorecord.com/api/external/v1/recordings" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json"
Replace your-subdomain with your actual workspace subdomain and your-api-key with your generated API key.

Step 2: Understanding the Response

A successful response will look like this JSON format:
{
  "recordings": [
    {
      "id": "recording-123",
      "title": "Product Demo",
      "default_title": "Recording 2025-01-15",
      "duration": 120.5,
      "view_count": 42,
      "is_uploaded": true,
      "requested": false,
      "summary": "A walkthrough of the new product features.",
      "public_link_id": "abc123",
      "transcoded_url": "https://cdn.neetorecord.com/...",
      "thumbnail_url": "https://cdn.neetorecord.com/...",
      "user_name": "Jane Smith",
      "tags": [
        {
          "id": "tag-1",
          "name": "Demo",
          "style": "blue"
        }
      ],
      "folder_name": "Product Demos",
      "folder_id": "folder-1",
      "created_at": "2025-01-15T10:30:00Z",
      "updated_at": "2025-01-15T10:30:00Z",
      "uploaded_at": "2025-01-15T10:31:00Z"
    }
  ],
  "pagination": {
    "total_records": 1,
    "total_pages": 1,
    "current_page_number": 1,
    "page_size": 30
  }
}

Next Steps

Now that you’ve made your first API call, you can: