Get Company
curl --request GET \
--url https://api.example.com/companies/{id}import requests
url = "https://api.example.com/companies/{id}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/companies/{id}', 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.example.com/companies/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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.example.com/companies/{id}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/companies/{id}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/companies/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"data.id": "<string>",
"data.name": "<string>",
"data.slug": "<string>",
"data.industry": "<string>",
"data.country": "<string>",
"data.timezone": "<string>",
"data.currency": "<string>",
"data.registration_number": "<string>",
"data.tax_id": "<string>",
"data.address": "<string>",
"data.phone": "<string>",
"data.logo_url": "<string>",
"data.status": "<string>",
"data.settings": {},
"data.created_at": "<string>",
"data.updated_at": "<string>"
}
}Companies
Get Company
GET
/
companies
/
{id}
Get Company
curl --request GET \
--url https://api.example.com/companies/{id}import requests
url = "https://api.example.com/companies/{id}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/companies/{id}', 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.example.com/companies/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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.example.com/companies/{id}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/companies/{id}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/companies/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"data.id": "<string>",
"data.name": "<string>",
"data.slug": "<string>",
"data.industry": "<string>",
"data.country": "<string>",
"data.timezone": "<string>",
"data.currency": "<string>",
"data.registration_number": "<string>",
"data.tax_id": "<string>",
"data.address": "<string>",
"data.phone": "<string>",
"data.logo_url": "<string>",
"data.status": "<string>",
"data.settings": {},
"data.created_at": "<string>",
"data.updated_at": "<string>"
}
}Retrieve detailed information about a specific company by its ID.
Path Parameters
string
required
Company UUID
Response
boolean
Indicates if the request was successful
object
The company object
string
Company UUID
string
Company name
string
Company slug identifier
string
Industry sector
string
Country location
string
Timezone identifier
string
Currency code
string
Registration number
string
Tax identification
string
Physical address
string
Contact phone
string
Logo URL
string
Company status
object
Company settings (JSON)
string
Creation timestamp (ISO 8601)
string
Last update timestamp (ISO 8601)
Request Example
cURL
curl -X GET https://api.companyflow.com/companies/123e4567-e89b-12d3-a456-426614174000 \
-H "Authorization: Bearer YOUR_JWT_TOKEN"
Response Example
200 OK
{
"success": true,
"data": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Acme Corporation",
"slug": "acme-corp",
"industry": "Technology",
"country": "United States",
"timezone": "America/New_York",
"currency": "USD",
"registration_number": "123456789",
"tax_id": "98-7654321",
"address": "123 Main St, New York, NY 10001",
"phone": "+1-555-0100",
"logo_url": "https://example.com/logo.png",
"status": "active",
"settings": null,
"created_at": "2026-03-03T10:00:00Z",
"updated_at": "2026-03-03T10:00:00Z"
}
}
400 Bad Request
{
"success": false,
"message": "invalid company id"
}
500 Internal Server Error
{
"success": false,
"message": "internal server error"
}
Error Responses
| Status Code | Description |
|---|---|
| 400 | Invalid company ID format (must be valid UUID) |
| 500 | Internal server error |