--- title: "List all deals" url: "https://docs.unified.to/crm/deal/List_all_deals" description: "API reference for List all deals. Launch multiple pre-built Deal integrations today with zero maintenance — all through a single API." generated_at: "2026-05-22T23:26:56.648Z" --- # List all deals GET/crm/{connection\_id}/deal ## Parameters **limit**number default=100 **offset**number default=0 **updated\_gte**date Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **sort** enum name updated\_at created\_at **order** enum asc desc **query**string Query string to search. eg. email address or name **company\_id**string The company ID to filter by (reference to CrmCompany) **contact\_id**string The contact ID to filter by (reference to CrmContact) **user\_id**string The user/employee ID to filter by (reference to HrisEmployee) **pipeline\_id**string The pipeline ID to filter by **fields**string array id created\_at updated\_at name amount currency closed\_at closing\_at stage stage\_id pipeline pipeline\_id stages pipelines source probability tags lost\_reason won\_reason user\_id contact\_ids company\_ids metadata raw Fields to return **raw**string Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar **connection\_id**string required ID of the connection ## Returns [CrmDeal](/crm/deal/model)array A deal represents an opportunity with companies and/or contacts **id**string Unique identifier for this deal object **created\_at**date The date that this deal object was created (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **updated\_at**date The last date that this deal object was updated (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **name**string The name of this deal **amount**number The potential amount that deal could be worth **currency**string The currency for the deal amount (3 letter ISO code; eg. USD) **closed\_at**date The date that this deal closed (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **closing\_at**date expected closing date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **stage**string @deprecated Use stages array instead **stage\_id**string @deprecated Use stages array instead **pipeline**string @deprecated Use pipelines array instead **pipeline\_id**string @deprecated Use pipelines array instead **stages** array **pipelines** array **source**string The source for this deal **probability**number **tags**string array **lost\_reason**string **won\_reason**string **user\_id**string (reference to HrisEmployee) **contact\_ids**string array (reference to CrmContact) **company\_ids**string array (reference to CrmCompany) **metadata** array **raw**any The raw data returned by the integration for this deal ## Code Samples ### Node.js SDK ``` import { UnifiedTo } from '@unified-api/typescript-sdk'; const sdk = new UnifiedTo({ security: { jwt: '', }, }); const connectionId = '5de520f96e439b002043d8dc'; const results = await sdk.crm.listCrmDeals({ connectionId, limit: 50, offset: 0, updated_gte: '2026-05-22T23:26:07.717Z', sort: 'updated_at', order: 'asc', query: '', company_id: '', contact_id: '', user_id: '', pipeline_id: '', fields: '', raw: '', }); ``` ### Node.js (axios) ``` const options = { method: 'GET', url: 'https://api.unified.to/crm/5de520f96e439b002043d8dc/deal', headers: { authorization: 'bearer .....' }, params: { limit: 50, offset: 0, updated_gte: '2026-05-22T23:26:07.717Z', sort: 'updated_at', order: 'asc', query: '', company_id: '', contact_id: '', user_id: '', pipeline_id: '', fields: '', raw: '', } }; const results = await axios.request(options); ``` ### Java ``` AsyncHttpClient client = new DefaultAsyncHttpClient(); client.prepare("GET", "https://api.unified.to/crm/5de520f96e439b002043d8dc/deal?limit=50&offset=0&updated_gte=2026-05-22T23:26:07.717Z&sort=updated_at&order=asc&query=&company_id=&contact_id=&user_id=&pipeline_id=&fields=&raw=") .setHeader("accept", "application/json") .setHeader("authorization", ".....") .execute() .toCompletableFuture() .thenAccept(System.out::println) .join(); client.close(); ``` ### Go ``` import ( "fmt" "net/http" "io/ioutil" ) url := `https://api.unified.to/crm/5de520f96e439b002043d8dc/deal?limit=50&offset=0&updated_gte=2026-05-22T23:26:07.717Z&sort=updated_at&order=asc&query=&company_id=&contact_id=&user_id=&pipeline_id=&fields=&raw= req, _ := http.NewRequest("GET", url, nil) req.Header.Add("accept", "application/json") req.Header.Add("authorization", ".....") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := ioutil.ReadAll(res.Body) ``` ### Python ``` import requests url = "https://api.unified.to/crm/5de520f96e439b002043d8dc/deal?limit=50&offset=0&updated_gte=2026-05-22T23:26:07.717Z&sort=updated_at&order=asc&query=&company_id=&contact_id=&user_id=&pipeline_id=&fields=&raw=" headers = { "accept": "application/json", "authorization": "....." } response = requests.get(url, headers=headers) ``` ### PHP ``` $curl = curl_init(); curl_setopt_array($curl, [ CURLOPT_URL => "https://api.unified.to/crm/5de520f96e439b002043d8dc/deal?limit=50&offset=0&updated_gte=2026-05-22T23:26:07.717Z&sort=updated_at&order=asc&query=&company_id=&contact_id=&user_id=&pipeline_id=&fields=&raw=", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "GET", CURLOPT_HTTPHEADER => [ "accept: application/json", "authorization: ....." ], ]); ``` ### Ruby ``` require 'uri' require 'net/http' require 'openssl' url = URI("https://api.unified.to/crm/5de520f96e439b002043d8dc/deal?limit=50&offset=0&updated_gte=2026-05-22T23:26:07.717Z&sort=updated_at&order=asc&query=&company_id=&contact_id=&user_id=&pipeline_id=&fields=&raw=") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["accept"] = 'application/json' request["authorization"] = '....' response = http.request(request) puts response.read_body ``` ### cURL ``` curl --request GET \ --url 'https://api.unified.to/crm/5de520f96e439b002043d8dc/deal?limit=50&offset=0&updated_gte=2026-05-22T23:26:07.717Z&sort=updated_at&order=asc&query=&company_id=&contact_id=&user_id=&pipeline_id=&fields=&raw=' \ --header 'accept: application/json' \ --header 'authorization: .....' ```