Skip to main content
GET
/
opportunities
List opportunities
curl --request GET \
  --url https://www.ruddr.io/api/workspace/opportunities \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "id": "7bcf2403-c6ea-4f9a-a9fa-bfa53a0d43b8",
      "name": "Acme Corp - Mobile App",
      "description": "Proposal for a new mobile application.",
      "nextSteps": "Follow up with client on proposal.",
      "amount": 50000,
      "isActive": true,
      "probability": 0.75,
      "priorityId": "high",
      "createdAt": "2025-01-15T20:47:03.284Z",
      "openDate": "2025-01-15",
      "closeDate": "2025-06-30",
      "modifiedAt": "2025-01-15T20:47:03.284Z",
      "currency": "USD",
      "cloudFolderUrl": "https://drive.google.com/drive/folders/abc123",
      "owner": {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "name": "John Davis"
      },
      "opportunityType": {
        "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "name": "New Business"
      },
      "opportunityLeadSource": {
        "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
        "name": "Referral"
      },
      "company": {
        "id": "d4e5f6a7-b8c9-0123-4567-89abcdef0123",
        "name": "Acme Corp",
        "client": {
          "id": "e5f6a7b8-c9d0-1234-5678-9abcdef01234",
          "key": "acme-corp",
          "name": "Acme Corp"
        }
      },
      "practice": {
        "id": "f6a7b8c9-d0e1-2345-6789-abcdef012345",
        "name": "Consulting"
      },
      "tags": [
        {
          "id": "1a2b3c4d-5e6f-7890-abcd-ef1234567890",
          "name": "Enterprise"
        }
      ],
      "opportunityStage": {
        "id": "2b3c4d5e-6f7a-8901-bcde-f12345678901",
        "name": "Proposal",
        "statusId": "open"
      },
      "projects": [
        {
          "id": "3c4d5e6f-7a8b-9012-cdef-123456789012",
          "name": "Mobile App Development",
          "amount": 50000
        }
      ],
      "weightedAmount": 37500,
      "timeSpent": 120,
      "salesforceId": "0060b00000BkFxAAAV",
      "hubspotId": "12345678"
    }
  ],
  "hasMore": false
}
A potential business deal within a company, typically with an associated revenue value and sales details like stage, owner, probability, and expected close date.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
startingAfter
string

A cursor ID (uuid) used to request the next page of results. If not provided, defaults to the first page of results.

​
endingBefore
string

A cursor ID (uuid) used to request the previous page of results. Is mutually exclusive with startingAfter.

​
limit
string

The maximum number of results to be returned. Can be any number from 1 to 100. Defaults to 10, if not provided.

​
name
string

Filter by opportunity name when it exactly matches the provided keyword.

Response

200

​
results
object[]
​
hasMore
boolean

Whether there are more results available after this page.