List deals

GET

deals

List deals

curl --request GET \
  --url https://api.opennous.cloud/v2/deals \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.opennous.cloud/v2/deals', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.opennous.cloud/v2/deals",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.opennous.cloud/v2/deals"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.opennous.cloud/v2/deals")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "deals": [
    {
      "id": "d3c1b2a0-5e4f-4a7b-9c8d-1e2f3a4b5c6d",
      "name": "Acme — 40 seats",
      "account": {
        "entity_id": "3e7a1d52-8c4b-4b9e-a0f3-6d2c9e8b7a15",
        "name": "Acme",
        "domain": "acme.com"
      },
      "stage": "Discovery call",
      "canonical_stage": "discovery",
      "status": "open",
      "amount": 48000,
      "currency": "USD",
      "close_date": "2026-11-15",
      "owner": {
        "name": "Jordan Lee",
        "email": "jordan@yourco.com"
      },
      "pipeline": {
        "id": "default",
        "name": "Sales pipeline"
      },
      "health": 71,
      "win_probability": 0.42,
      "close_within_30d": 0.18,
      "last_activity_at": "2026-09-24T15:02:00Z",
      "implied": false
    },
    {
      "id": "implied:3e7a1d52-8c4b-4b9e-a0f3-6d2c9e8b7a15",
      "name": "Acme deal",
      "account": {
        "entity_id": "3e7a1d52-8c4b-4b9e-a0f3-6d2c9e8b7a15",
        "name": "Acme",
        "domain": "acme.com"
      },
      "stage": "Discovery",
      "canonical_stage": "discovery",
      "status": "open",
      "amount": null,
      "currency": null,
      "close_date": null,
      "owner": {
        "name": "Jordan Lee",
        "email": "jordan@yourco.com"
      },
      "pipeline": null,
      "health": 71,
      "win_probability": 0.42,
      "close_within_30d": 0.18,
      "last_activity_at": "2026-09-24T15:02:00Z",
      "implied": true
    }
  ],
  "limit": 50,
  "offset": 0,
  "has_more": false
}

Deals are read-only. Your CRM is the source of truth, and OpenNous reads it.

Implied deals

An account with no CRM deal still has a deal, its implied deal. That covers workspaces without a CRM and accounts the CRM has no deal for. An implied deal has the id implied:<account_id> and implied: true. Its stage is the account’s stage, and it has no pipeline or close date. It works anywhere a deal id does, in get a deal and as the focus of get context.

How the objects fit

Object	Created by	Linked to	`stage` means
Person	Activity from your connected tools	The account they work at, and the deals they are on	How far that person’s thread has gone
Account	Activity, or the CRM	Its people and its deals	The furthest stage among its people
Deal	Your CRM, or implied for an account without one	One account, and its stakeholders	The CRM stage, mapped onto the standard ladder as `canonical_stage`

All three share the standard ladder. See list pipelines for how your CRM stages map onto it.

curl "https://api.opennous.cloud/v2/deals?status=open&closing_within_days=30&sort=win_probability" \
  -H "Authorization: Bearer $NOUS_API_KEY"

Authorizations

Authorization

string

header

required

Workspace API key. Create one in Settings → API keys.

Query Parameters

account

string

Only one account's deals. Entity UUID or domain.

pipeline

string

CRM pipeline id. Excludes implied deals.

status

enum<string>

Deal status.

Available options:

open,

won,

lost

stage

enum<string>

Standard stage (canonical_stage).

Available options:

identified,

connected,

interested,

meeting_booked,

discovery,

demo,

negotiation,

closed_won,

closed_lost,

disqualified,

churned

owner

string

CRM owner. An email or a name.

closing_within_days

integer

Open deals with a close date from today to N days out. Excludes implied deals.

Required range: 1 <= x <= 3650

min_amount

number

Minimum amount.

implied

boolean

true for implied deals only, false for CRM deals only.

sort

enum<string>

default:last_activity

close_date is soonest first. The others are highest or newest first.

Available options:

last_activity,

close_date,

amount,

win_probability

limit

integer

default:50

Page size.

Required range: 1 <= x <= 200

offset

integer

default:0

Rows to skip.

Required range: x >= 0

Response

A page of deals.

deals

object[]

Show child attributes

limit

integer

offset

integer

has_more

boolean

List deals

curl --request GET \
  --url https://api.opennous.cloud/v2/deals \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.opennous.cloud/v2/deals', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.opennous.cloud/v2/deals",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.opennous.cloud/v2/deals"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.opennous.cloud/v2/deals")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "deals": [
    {
      "id": "d3c1b2a0-5e4f-4a7b-9c8d-1e2f3a4b5c6d",
      "name": "Acme — 40 seats",
      "account": {
        "entity_id": "3e7a1d52-8c4b-4b9e-a0f3-6d2c9e8b7a15",
        "name": "Acme",
        "domain": "acme.com"
      },
      "stage": "Discovery call",
      "canonical_stage": "discovery",
      "status": "open",
      "amount": 48000,
      "currency": "USD",
      "close_date": "2026-11-15",
      "owner": {
        "name": "Jordan Lee",
        "email": "jordan@yourco.com"
      },
      "pipeline": {
        "id": "default",
        "name": "Sales pipeline"
      },
      "health": 71,
      "win_probability": 0.42,
      "close_within_30d": 0.18,
      "last_activity_at": "2026-09-24T15:02:00Z",
      "implied": false
    },
    {
      "id": "implied:3e7a1d52-8c4b-4b9e-a0f3-6d2c9e8b7a15",
      "name": "Acme deal",
      "account": {
        "entity_id": "3e7a1d52-8c4b-4b9e-a0f3-6d2c9e8b7a15",
        "name": "Acme",
        "domain": "acme.com"
      },
      "stage": "Discovery",
      "canonical_stage": "discovery",
      "status": "open",
      "amount": null,
      "currency": null,
      "close_date": null,
      "owner": {
        "name": "Jordan Lee",
        "email": "jordan@yourco.com"
      },
      "pipeline": null,
      "health": 71,
      "win_probability": 0.42,
      "close_within_30d": 0.18,
      "last_activity_at": "2026-09-24T15:02:00Z",
      "implied": true
    }
  ],
  "limit": 50,
  "offset": 0,
  "has_more": false
}

Overview

People

Accounts

Deals

Notes

Attention

Insights

Enrich & score

Organization

Workflows

Webhooks

Usage

Implied deals

How the objects fit

Authorizations

Query Parameters

Response

​Implied deals

​How the objects fit

Authorizations

Query Parameters

Response

Implied deals

How the objects fit