Skip to main content
GET
/
v3
/
content
List Content
curl --request GET \
  --url https://api.proposales.com/v3/content \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "created_at": 123,
      "description": {},
      "product_id": 123,
      "variation_id": 123,
      "title": {},
      "is_archived": {},
      "sources": {},
      "images": [
        {}
      ],
      "integration_id": 123,
      "integration_metadata": {}
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.proposales.com/llms.txt

Use this file to discover all available pages before exploring further.

​
company_id
number
Limits results to one company the token can access. Required when using external_id unless you also pass variation_id, or product_id that resolves to at least one variation for this token (integration or Oracle external lookup).
​
external_id
string
Look up content by external identifier:
  • Integration imports: matches sources.integration.uniqueId exactly (case-sensitive), as set during content import.
  • Oracle: same parameter also matches sources.oracle.code (case-insensitive), preserving existing behaviour.
If external_id is not scoped with variation_id or a product_id that resolves to variations for this token, you must pass company_id.
​
variation_id
string
Variation ID filter, can be single ID or multiple comma separated ones. When provided, detailed information will be included in the response.
​
product_id
string
Product ID filter, can be single ID or multiple comma separated ones. When provided, detailed information will be included in the response. Alternative to variation_id - you can use either parameter.
​
include_archived
boolean
default:"false"
Set to true to include archived content in the response. By default, only active (non-archived) content is returned.
​
include_sources
boolean
default:"false"
Set to true to include the sources field in the response. This contains integration metadata like connections to Opera, Mews or other systems.
Content can be products or videos and are found in the content library. They can be attached to a proposal as blocks.

​
Example Requests

List all content: 
GET /v3/content
Get specific content by product IDs: 
GET /v3/content?product_id=123,456
Get specific content by variation IDs: 
GET /v3/content?variation_id=789,101112
Mix both ID types: 
GET /v3/content?product_id=123&variation_id=789
Include archived content: 
GET /v3/content?include_archived=true
Resolve by integration external id (stable uniqueId from the vendor): 
GET /v3/content?company_id=123&external_id=vendor-product-abc

​
Response

​
data
Content[]