Skip to main content
GET
/
v1
/
portfolios
/
{id}
Get Portfolio
curl --request GET \
  --url https://api.example.com/v1/portfolios/{id}
{
  "id": "ptf_abc123",
  "object": "portfolio",
  "name": "Core Brand Marks",
  "description": "Primary brand trademarks",
  "mark_count": 47,
  "marks": [
    {
      "trademark_id": "tm_def456",
      "mark_text": "SIGNA",
      "office_code": "uspto",
      "jurisdiction_code": "US",
      "status": { "stage": "registered" },
      "added_at": "2026-03-24T12:00:00Z"
    }
  ],
  "created_at": "2026-03-24T12:00:00Z",
  "updated_at": "2026-03-24T14:30:00Z",
  "livemode": true,
  "request_id": "req_xyz789"
}

Path Parameters

id
string
required
Portfolio ID (e.g., ptf_abc123)

Response

{
  "id": "ptf_abc123",
  "object": "portfolio",
  "name": "Core Brand Marks",
  "description": "Primary brand trademarks",
  "mark_count": 47,
  "marks": [
    {
      "trademark_id": "tm_def456",
      "mark_text": "SIGNA",
      "office_code": "uspto",
      "jurisdiction_code": "US",
      "status": { "stage": "registered" },
      "added_at": "2026-03-24T12:00:00Z"
    }
  ],
  "created_at": "2026-03-24T12:00:00Z",
  "updated_at": "2026-03-24T14:30:00Z",
  "livemode": true,
  "request_id": "req_xyz789"
}