---
updatedAt: 2026-07-05T02:39:40.000Z
agentTools:
  projectIndex: https://redbricks.readme.io/llms.txt
---

# List all sales & marketing companies

Retrieve a collection of all sales & marketing companies with pagination.

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Red Bricks Data API Documentation",
    "description": "<h2>Introduction</h2>\n\n<p>\nWelcome to the Real Estate Projects API documentation.<br>\nThis REST API provides a robust and secure programming interface for integrating, retrieving, and managing data related to real estate projects, including projects, floorplans, pricing, locations, developers, and associated companies.<br>\nIt is designed to support seamless integration with external systems and partner solutions.\n</p>\n\n<p>\nThis documentation contains details about available endpoints, request and response formats, authentication, and practical usage examples.\n</p>\n\n<h3>Key Features</h3>\n<ul>\n    <li><strong>Architecture:</strong> RESTful, with resources accessed using HTTP GET requests.</li>\n    <li><strong>Data Format:</strong> All requests and responses use standard JSON.</li>\n    <li><strong>Authentication:</strong> Secure access using Team Command Tokens. All endpoints require authentication. See the <a href=\"#authenticating-requests\">Authenticating requests</a> section for details.</li>\n    <li><strong>Comprehensive Data:</strong> Provides access to projects, floorplans, cities, districts, neighbourhoods, developers, architects, interior designers, prices, documents, sales &amp; marketing companies, and special incentives.</li>\n    <li><strong>Rate Limiting:</strong> Up to 60 requests per minute per team. Exceeding this limit results in a <code>429 Too Many Requests</code> response.</li>\n    <li><strong>Error Handling:</strong> Standardized JSON error responses for common issues such as authentication failures (<code>401 Unauthenticated</code>), missing resources, and rate limits.</li>\n    <li><strong>Centralized Database:</strong> The API interacts with a centralized and regularly updated database of real estate projects.</li>\n</ul>\n\n<h3>404 Not Found responses</h3>\n<pre><code class=\"language-json\">HTTP/1.1 404 Not Found\nContent-Type: application/json\n\n{\n  \"message\": \"Resource not found\"\n}\n</code></pre>\n<pre><code class=\"language-json\">HTTP/1.1 404 Not Found\nContent-Type: application/json\n\n{\n  \"message\": \"Project not found\"\n}\n</code></pre>\n<p>\nThe API returns clear and consistent 404 responses in two main cases:\n</p>\n<ul>\n    <li>\n        <strong>Resource not found:</strong> If you request a non-existent endpoint (for example, a typo in the URL), you will receive:\n\n    </li>\n</ul>\n\n<ul>\n    <li>\n        <strong>{Model} not found:</strong> If you request a valid endpoint but the specific resource (like a Project, Developer, etc.) does not exist, you will receive:\n        <em>The model name in the message will match the type of resource you requested (e.g., \"Developer not found\").</em>\n    </li>\n</ul>\n\n<h3>How to Use</h3>\n<ol>\n    <li><strong>Obtain your team command token</strong> from your team administrator or team management dashboard.</li>\n    <li><strong>Include your team token</strong> in the <code>Authorization</code> header of every request:<br>\n        <code>Authorization: Bearer {YOUR_TEAM_TOKEN}</code>\n    </li>\n    <li><strong>Explore the available endpoints</strong> below to find the data you need.</li>\n</ol>\n\n<p>\nIf you have any questions or need support, please contact your API administrator.\n</p>\n",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://api.redbricks.ca"
    }
  ],
  "tags": [
    {
      "name": "Sales & Marketing Companies",
      "description": ""
    }
  ],
  "components": {
    "securitySchemes": {
      "default": {
        "type": "http",
        "scheme": "bearer",
        "description": "<p>\n    This API uses <strong>Team Command Token Authentication</strong>.<br>\n    To authenticate, include your team command token in the <code>Authorization</code> header of every request, prefixed\n    with <code>Bearer</code>.<br>\n</p>\n<p><strong>Example header:</strong></p>\n<pre>Authorization: Bearer {API_TOKEN}</pre>\n<br/>\n<br/>\n<br/>\n<p>\n    Team command tokens are associated with your team account and provide access to all API endpoints.<br>\n    You can obtain your team command token from your team administrator or through your team management dashboard.<br>\n    Keep your token secure and never share it with unauthorized users.\n</p>\n<p>\n    <strong>Note:</strong> All API endpoints require authentication. Requests without a valid team token will be\n    rejected.\n</p>\n<p>\n    If your token is missing, expired, or invalid, you will receive one of the following error responses:\n</p>\n<pre>\nHTTP/1.1 401 Unauthorized\nContent-Type: application/json\n\n{\n  \"message\": \"Team token is required\"\n}\n</pre>\n<pre>\nHTTP/1.1 401 Unauthorized\nContent-Type: application/json\n\n{\n  \"message\": \"Invalid or expired team token\"\n}\n</pre>\n<pre>\nHTTP/1.1 401 Unauthorized\nContent-Type: application/json\n\n{\n  \"message\": \"Team token has expired\"\n}\n</pre>\n"
      }
    }
  },
  "security": [
    {
      "default": []
    }
  ],
  "paths": {
    "/api/v1/sales-marketing-companies": {
      "get": {
        "summary": "List all sales & marketing companies",
        "operationId": "listAllSalesMarketingCompanies",
        "description": "Retrieve a collection of all sales & marketing companies with pagination.",
        "parameters": [
          {
            "in": "query",
            "name": "search",
            "description": "Search sales & marketing companies by name.",
            "example": "Realty",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Search sales & marketing companies by name.",
              "example": "Realty"
            }
          },
          {
            "in": "query",
            "name": "page",
            "description": "The page number for pagination.",
            "example": 2,
            "required": false,
            "schema": {
              "type": "integer",
              "description": "The page number for pagination.",
              "example": 2
            }
          },
          {
            "in": "query",
            "name": "per_page",
            "description": "Number of sales & marketing companies per page. Default: 20. Max: 50.",
            "example": 50,
            "required": false,
            "schema": {
              "type": "integer",
              "description": "Number of sales & marketing companies per page. Default: 20. Max: 50.",
              "example": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string",
                  "example": "{\n  \"data\": [\n    {\n      \"id\": 1,\n      \"name\": \"Realty Sales Inc.\",\n      \"slug\": \"realty-sales-inc\",\n    }\n  ],\n  \"links\": {\n    \"first\": \"http://your-app.test/api/v1/sales-marketing-companies?page=1\",\n    \"last\": \"http://your-app.test/api/v1/sales-marketing-companies?page=5\",\n    \"prev\": null,\n    \"next\": \"http://your-app.test/api/v1/sales-marketing-companies?page=2\"\n  },\n  \"meta\": {\n    \"current_page\": 1,\n    \"from\": 1,\n    \"last_page\": 5,\n    \"path\": \"http://your-app.test/api/v1/sales-marketing-companies\",\n    \"per_page\": 20,\n    \"to\": 20,\n    \"total\": 100\n  }\n}"
                }
              }
            }
          },
          "401": {
            "description": "Unauthenticated",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "example": {
                    "message": "Unauthenticated."
                  },
                  "properties": {
                    "message": {
                      "type": "string",
                      "example": "Unauthenticated."
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Sales & Marketing Companies"
        ]
      }
    }
  }
}
```