> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plyne.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Monitored Accounts

> Read monitored accounts with their latest account signal.

Monitored Accounts are companies your team tracks over time. Use this endpoint to read the same account queue you see in the dashboard, including account-level score, summary, and latest signal.

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --url 'https://api.plyne.ai/v1/monitor/accounts' \
    --header 'Authorization: Bearer plyne_...' \
    --header 'Content-Type: application/json' \
    --data '{
      "signals": ["d8signaldefinitionid"],
      "statuses": ["detected"],
      "cursor": { "limit": 50 }
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id": "d8companyid",
        "name": "Current Electric",
        "domain": "currentelectric.com",
        "profile": {
          "platform": "linkedin",
          "url": "https://linkedin.com/company/current-electric"
        },
        "country_code": "US",
        "monitoring": {
          "id": "d8trackedentityid",
          "created_at": "2026-06-10T12:00:00Z"
        },
        "score": {
          "value": 84,
          "fit": "high",
          "reasoning": "Strong account movement based on recent detected signals."
        },
        "latest_signal": {
          "id": "d8signalid",
          "definition_id": "d8signaldefinitionid",
          "name": "Tech stack migration",
          "status": "detected",
          "score": 88,
          "summary": "Moved to ServiceTitan.",
          "observed_at": "2026-06-15T08:00:00Z"
        }
      }
    ],
    "cursor": {
      "next": "",
      "has_more": false
    }
  }
  ```
</ResponseExample>

```http theme={null}
POST /v1/monitor/accounts
```

<div className="plyne-api-meta">
  <section className="plyne-api-section">
    <h2>Authorizations</h2>

    <div className="plyne-param">
      <div className="plyne-param-title">
        <span className="plyne-param-name">Authorization</span>
        <span className="plyne-pill">string</span>
        <span className="plyne-pill">header</span>
        <span className="plyne-pill plyne-pill-required">required</span>
      </div>

      <p>Bearer authentication header of the form <code>Bearer \<token></code>, where <code>\<token></code> is your API key.</p>
    </div>
  </section>

  <section className="plyne-api-section">
    <h2>Body</h2>

    <div className="plyne-param">
      <div className="plyne-param-title">
        <span className="plyne-param-name">account\_ids</span>
        <span className="plyne-pill">string\[]</span>
      </div>

      <p>Return specific monitored accounts by company ID. Omit this field to return all monitored accounts.</p>
    </div>

    <div className="plyne-param">
      <div className="plyne-param-title">
        <span className="plyne-param-name">signals</span>
        <span className="plyne-pill">string\[]</span>
      </div>

      <p>Filter accounts by Custom Signal definition IDs.</p>
    </div>

    <div className="plyne-param">
      <div className="plyne-param-title">
        <span className="plyne-param-name">statuses</span>
        <span className="plyne-pill">string\[]</span>
      </div>

      <p>Filter by latest account signal status.</p>
      <p className="plyne-param-example">Example: <code>\["detected"]</code></p>
    </div>

    <div className="plyne-param">
      <div className="plyne-param-title">
        <span className="plyne-param-name">latest\_activity</span>
        <span className="plyne-pill">object</span>
      </div>

      <p>Restrict accounts by their latest monitored activity. Results use the dashboard's fixed Monitored priority order.</p>
    </div>

    <div className="plyne-param">
      <div className="plyne-param-title">
        <span className="plyne-param-name">cursor.limit</span>
        <span className="plyne-pill">integer</span>
      </div>

      <p>Number of monitored accounts to return. Maximum value is <code>100</code>.</p>
    </div>

    <div className="plyne-param">
      <div className="plyne-param-title">
        <span className="plyne-param-name">cursor.after</span>
        <span className="plyne-pill">string</span>
      </div>

      <p>Opaque cursor returned as <code>cursor.next</code> from the previous response.</p>
    </div>
  </section>
</div>