Skip to main content
GET
/
company
Get company information
curl --request GET \
  --url https://api.firma.dev/functions/v1/signing-request-api/company \
  --header 'Authorization: <api-key>'
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "company_name": "Acme Corporation",
  "account_owner": "John Doe",
  "account_owner_email": "john@acme.com",
  "website": "https://acme.com",
  "icon_url": "https://acme.com/logo.png",
  "credits": 1000,
  "date_created": "2024-01-15T10:30:00Z",
  "date_changed": "2024-03-20T14:25:00Z"
}

Authorizations

​
Authorization
string
header
required

API key for authentication. Use your API key directly without any prefix (e.g., 'your-api-key'). Bearer prefix is optional but not required.

Response

Company information retrieved successfully

​
id
string<uuid>

Unique identifier for the company

​
company_name
string

Company name

Maximum string length: 255
​
account_owner
string

Name of the account owner

Maximum string length: 255
​
account_owner_email
string<email>

Email address of the account owner

​
website
string<uri> | null

Company website URL

​
icon_url
string<uri> | null

URL to company icon/logo

​
credits
integer

Available credits for the company (read-only, managed internally)

Required range: x >= 0
​
date_created
string<date-time>

Company account creation timestamp

​
date_changed
string<date-time>

Company account last update timestamp