List companies
curl --request GET \
--url https://www.ruddr.io/api/workspace/companies \
--header 'Authorization: Bearer <token>'import requests
url = "https://www.ruddr.io/api/workspace/companies"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://www.ruddr.io/api/workspace/companies', 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://www.ruddr.io/api/workspace/companies",
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://www.ruddr.io/api/workspace/companies"
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))
}HttpResponse<String> response = Unirest.get("https://www.ruddr.io/api/workspace/companies")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://www.ruddr.io/api/workspace/companies")
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{
"results": [
{
"id": "a3f1c2d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"name": "Acme Corp",
"isActive": true,
"description": "Enterprise technology company.",
"billingAddress": "100 Market St, Suite 500, San Francisco, CA 94105",
"currency": "USD",
"facebookUrl": "https://facebook.com/acmecorp",
"linkedinUrl": "https://linkedin.com/company/acmecorp",
"twitterUrl": "https://twitter.com/acmecorp",
"websiteUrl": "https://acmecorp.com",
"numberOfEmployees": 5000,
"ownershipClass": "public",
"phoneNumber": "(555) 987-6543",
"revenue": 125000000,
"shippingAddress": "100 Market St, Suite 500, San Francisco, CA 94105",
"tickerSymbol": "ACME",
"yearFounded": 1985,
"createdAt": "2025-01-15T20:47:03.284Z",
"modifiedAt": "2025-01-15T20:47:03.284Z",
"companySpendTier": {
"id": "b4e2d3f5-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
"name": "Enterprise"
},
"companyType": {
"id": "c5f3e4a6-7b8c-4d9e-0f1a-2b3c4d5e6f7a",
"name": "Customer"
},
"practice": {
"id": "d6a4f5b7-8c9d-4e0f-1a2b-3c4d5e6f7a8b",
"name": "Technology"
},
"industry": {
"id": "e7b5a6c8-9d0e-4f1a-2b3c-4d5e6f7a8b9c",
"name": "Technology"
},
"owner": {
"id": "f8c6b7d9-0e1f-4a2b-3c4d-5e6f7a8b9c0d",
"name": "John Davis"
},
"sicCode": {
"id": "a9d7c8e0-1f2a-4b3c-4d5e-6f7a8b9c0d1e",
"code": "7372",
"industryTitle": "Prepackaged Software"
},
"salesforceId": "0011600001LtMCkAAN",
"hubspotId": "12345678"
}
],
"hasMore": false
}{
"status": 400,
"message": "Parameter 'startingAfter' is not a valid UUID."
}{
"status": 403,
"message": "Feature 'Pipeline' is not enabled."
}Companies
List companies
GET
/
companies
List companies
curl --request GET \
--url https://www.ruddr.io/api/workspace/companies \
--header 'Authorization: Bearer <token>'import requests
url = "https://www.ruddr.io/api/workspace/companies"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://www.ruddr.io/api/workspace/companies', 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://www.ruddr.io/api/workspace/companies",
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://www.ruddr.io/api/workspace/companies"
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))
}HttpResponse<String> response = Unirest.get("https://www.ruddr.io/api/workspace/companies")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://www.ruddr.io/api/workspace/companies")
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{
"results": [
{
"id": "a3f1c2d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"name": "Acme Corp",
"isActive": true,
"description": "Enterprise technology company.",
"billingAddress": "100 Market St, Suite 500, San Francisco, CA 94105",
"currency": "USD",
"facebookUrl": "https://facebook.com/acmecorp",
"linkedinUrl": "https://linkedin.com/company/acmecorp",
"twitterUrl": "https://twitter.com/acmecorp",
"websiteUrl": "https://acmecorp.com",
"numberOfEmployees": 5000,
"ownershipClass": "public",
"phoneNumber": "(555) 987-6543",
"revenue": 125000000,
"shippingAddress": "100 Market St, Suite 500, San Francisco, CA 94105",
"tickerSymbol": "ACME",
"yearFounded": 1985,
"createdAt": "2025-01-15T20:47:03.284Z",
"modifiedAt": "2025-01-15T20:47:03.284Z",
"companySpendTier": {
"id": "b4e2d3f5-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
"name": "Enterprise"
},
"companyType": {
"id": "c5f3e4a6-7b8c-4d9e-0f1a-2b3c4d5e6f7a",
"name": "Customer"
},
"practice": {
"id": "d6a4f5b7-8c9d-4e0f-1a2b-3c4d5e6f7a8b",
"name": "Technology"
},
"industry": {
"id": "e7b5a6c8-9d0e-4f1a-2b3c-4d5e6f7a8b9c",
"name": "Technology"
},
"owner": {
"id": "f8c6b7d9-0e1f-4a2b-3c4d-5e6f7a8b9c0d",
"name": "John Davis"
},
"sicCode": {
"id": "a9d7c8e0-1f2a-4b3c-4d5e-6f7a8b9c0d1e",
"code": "7372",
"industryTitle": "Prepackaged Software"
},
"salesforceId": "0011600001LtMCkAAN",
"hubspotId": "12345678"
}
],
"hasMore": false
}{
"status": 400,
"message": "Parameter 'startingAfter' is not a valid UUID."
}{
"status": 403,
"message": "Feature 'Pipeline' is not enabled."
}An organization with which you have a history of communication or business, such as a potential client or partner. Each company can be linked to one or more contacts.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
A cursor ID (uuid) used to request the next page of results. If not provided, defaults to the first page of results.
A cursor ID (uuid) used to request the previous page of results. Is mutually exclusive with startingAfter.
The maximum number of results to be returned. Can be any number from 1 to 100. Defaults to 10, if not provided.
Filter companies by name (exact match).
⌘I