Supersociedades Financial Statements
curl --request POST \
--url https://api.croma.run/co/supersociedades/financial-statements/v1 \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"document_number": "900249127"
}
'import requests
url = "https://api.croma.run/co/supersociedades/financial-statements/v1"
payload = { "document_number": "900249127" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({document_number: '900249127'})
};
fetch('https://api.croma.run/co/supersociedades/financial-statements/v1', 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.croma.run/co/supersociedades/financial-statements/v1",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'document_number' => '900249127'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.croma.run/co/supersociedades/financial-statements/v1"
payload := strings.NewReader("{\n \"document_number\": \"900249127\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.croma.run/co/supersociedades/financial-statements/v1")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"document_number\": \"900249127\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.croma.run/co/supersociedades/financial-statements/v1")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"document_number\": \"900249127\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"found": true,
"document_number": "<string>",
"company": {
"name": "<string>",
"status": "<string>",
"society_type": "<string>",
"primary_activity": {
"code": "<string>",
"description": "<string>"
},
"incorporation_date": "<string>",
"city": "<string>",
"department": "<string>",
"registration_number": "<string>"
},
"count": 123,
"capped": true,
"statements": [
{
"year": 123,
"cutoff_date": "<string>",
"filing_id": "<string>",
"reporting_unit": "<string>",
"income_statement": {
"revenue": 123,
"cost_of_sales": 123,
"gross_profit": 123,
"administrative_expenses": 123,
"selling_expenses": 123,
"other_income": 123,
"other_expenses": 123,
"finance_income": 123,
"finance_costs": 123,
"operating_profit": 123,
"profit_before_tax": 123,
"income_tax": 123,
"net_income": 123
},
"balance_sheet": {
"current_assets": 123,
"non_current_assets": 123,
"total_assets": 123,
"current_liabilities": 123,
"non_current_liabilities": 123,
"total_liabilities": 123,
"total_equity": 123,
"cash_and_equivalents": 123,
"inventories": 123,
"trade_receivables": 123,
"trade_payables": 123,
"issued_capital": 123,
"retained_earnings": 123
},
"cash_flow": {
"net_cash_from_operating": 123,
"net_cash_from_investing": 123,
"net_cash_from_financing": 123,
"cash_at_start": 123,
"cash_at_end": 123
}
}
]
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"details": {}
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"details": {}
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"details": {}
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"details": {}
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"details": {}
}
}Supersociedades Financial Statements
Annual financial statements a Colombian company has filed with Supersociedades, by NIT: income statement (revenue, gross/operating/net profit), balance sheet (assets, liabilities, equity) and cash flow per fiscal year, plus the company identity from the filing cover (razón social, status, CIIU, incorporation date). Returns the latest filing per fiscal year, newest first, up to 10 years; figures come as filed, in the unit each filing declares (reporting_unit, thousands of COP when declared; older filings declare none). found: false when the NIT has no filings on record.
POST
/
co
/
supersociedades
/
financial-statements
/
v1
Supersociedades Financial Statements
curl --request POST \
--url https://api.croma.run/co/supersociedades/financial-statements/v1 \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"document_number": "900249127"
}
'import requests
url = "https://api.croma.run/co/supersociedades/financial-statements/v1"
payload = { "document_number": "900249127" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({document_number: '900249127'})
};
fetch('https://api.croma.run/co/supersociedades/financial-statements/v1', 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.croma.run/co/supersociedades/financial-statements/v1",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'document_number' => '900249127'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.croma.run/co/supersociedades/financial-statements/v1"
payload := strings.NewReader("{\n \"document_number\": \"900249127\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.croma.run/co/supersociedades/financial-statements/v1")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"document_number\": \"900249127\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.croma.run/co/supersociedades/financial-statements/v1")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"document_number\": \"900249127\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"found": true,
"document_number": "<string>",
"company": {
"name": "<string>",
"status": "<string>",
"society_type": "<string>",
"primary_activity": {
"code": "<string>",
"description": "<string>"
},
"incorporation_date": "<string>",
"city": "<string>",
"department": "<string>",
"registration_number": "<string>"
},
"count": 123,
"capped": true,
"statements": [
{
"year": 123,
"cutoff_date": "<string>",
"filing_id": "<string>",
"reporting_unit": "<string>",
"income_statement": {
"revenue": 123,
"cost_of_sales": 123,
"gross_profit": 123,
"administrative_expenses": 123,
"selling_expenses": 123,
"other_income": 123,
"other_expenses": 123,
"finance_income": 123,
"finance_costs": 123,
"operating_profit": 123,
"profit_before_tax": 123,
"income_tax": 123,
"net_income": 123
},
"balance_sheet": {
"current_assets": 123,
"non_current_assets": 123,
"total_assets": 123,
"current_liabilities": 123,
"non_current_liabilities": 123,
"total_liabilities": 123,
"total_equity": 123,
"cash_and_equivalents": 123,
"inventories": 123,
"trade_receivables": 123,
"trade_payables": 123,
"issued_capital": 123,
"retained_earnings": 123
},
"cash_flow": {
"net_cash_from_operating": 123,
"net_cash_from_investing": 123,
"net_cash_from_financing": 123,
"cash_at_start": 123,
"cash_at_end": 123
}
}
]
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"details": {}
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"details": {}
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"details": {}
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"details": {}
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"details": {}
}
}Authorizations
Use Authorization: Bearer YOUR_API_KEY
Body
application/json
Colombian NIT (numeric, no verification digit). 4-15 digits.
Required string length:
4 - 15Pattern:
^\d{4,15}$Response
Successful response
Show child attributes
Show child attributes
⌘I