Organisations

Entity›Relation›Relation.Organization

Organisations represent companies and institutions in your CRM — the Relation_Organization entity type. An Organisation stores company information such as name, website, VAT number, and chamber of commerce details.

Not to be confused with "Customers"

An Organisation (Relation_Organization) is the entity itself — the company record. A Customer (Relationship_Organization_CommercialRelationship_Customer) is a Relationship that defines an Organisation's role as a customer of your business. The same Organisation can also be a Suspect, Lead, Hot Prospect, Prospect, Supplier, or Partner — each represented by a separate Relationship.

Endpoints

List Organizations

Retrieve a paginated list of organizations.

GET/v1/odata/Relation_Organization

Single Organization

Retrieve a single organization by its ID.

GET/v1/odata/Relation_Organization({id})

With expanded relations:

GET/v1/odata/Relation_Organization({id})?$expand=VisitingAddress,PostalAddress,Branch

Create Organization

Create a new organization.

POST/v1/odata/Relation_Organization

Update Organization

Update an existing organization. Provide only the fields to update.

PUT/v1/odata/Relation_Organization({id})

Delete Organization

Delete an organization by ID.

DELETE/v1/odata/Relation_Organization({id})

Fields

Standard Fields (all entities)

These fields are present on every entity, including organizations.

Field	Type	Description
ID	Guid	Primary key (UUID)
_Type	String	Entity type discriminator (Relation.Organization)
_Name	String	Display name
SortIndex	Double	Sorting order

Organization Fields

Field	Type	Required	Description
name	String	Yes	Organization name
phoneNumber	String	No	Phone number
emailAddress	String	No	Primary email address
financialEmailAddress	String	No	Email for invoicing
website	String	No	Website URL
vatNumber	String	No	VAT number
chamberOfCommerceNumber	String	No	Chamber of Commerce (KVK) number
chamberOfCommerceName	String	No	Name as registered at KVK
establishmentNumber	Double	No	KVK establishment number
companyActivity	String	No	Business activity description (KVK)
numberOfEmployees	Double	No	Number of employees (KVK)
oin	String	No	Organization Identification Number
rsin	String	No	Tax identification number (RSIN)
foundingDate	Date	No	Date the organization was founded
establishmentDate	Date	No	Date of establishment registration
discontinuationDate	Date	No	Date the organization was discontinued
issueDate	DateTimeOffset	No	Registration issue date
expirationDate	DateTimeOffset	No	Registration expiration date

Inherited Fields (from Relation)

These fields are inherited from the parent Relation type and available on all organizations.

Field	Type	Description
number	Double	Relation number
picture	File	Profile picture
debtorNumber	String	Debtor number
creditorNumber	String	Creditor number
iban	String	IBAN bank account number
bic	String	BIC/SWIFT code
bankName	String	Bank name
facebook	String	Facebook URL
twitter	String	Twitter/X URL
linkedin	String	LinkedIn URL
blog	String	Blog URL

Relationships

Relationship	Target Entity	Cardinality	Description
VisitingAddress	Address	1:N	Visiting/office address
PostalAddress	Address	1:N	Postal/mailing address
InvoiceAddress	Address	1:N	Invoice address
Branch	Datastore.Branch	N:1	KVK branch classification
LegalForm	Datastore.LegalForm	N:1	Legal form (BV, NV, etc.)
Language	Datastore.Language	N:1	Preferred language
LegalEntity	LegalEntity	N:1	Legal entity reference
Suspect	Relationship_Organization_CommercialRelationship_Suspect	N:N	Unqualified company contact (top of funnel)
Lead	Relationship_Organization_CommercialRelationship_Lead	N:N	Qualified company lead
HotProspect	Relationship_Organization_CommercialRelationship_HotProspect	N:N	Engaged company showing buying signals
Prospect	Relationship_Organization_CommercialRelationship_Prospect	N:N	Company in active negotiation
Customer	Relationship_Organization_CommercialRelationship_Customer	N:N	Signed company customer
Supplier	Relationship_Organization_Supplier	N:N	Company that supplies your business
Identity	Relationship_Organization_Identity	N:N	Your own organisation identity record

Expanding Relationships

GET/v1/odata/Relation_Organization({id})?$expand=VisitingAddress

GET/v1/odata/Relation_Organization({id})?$expand=VisitingAddress,PostalAddress,Branch,LegalForm

Navigating Relationships

You can navigate directly to related entities:

GET/v1/odata/Relation_Organization({id})/VisitingAddress

DELETE/v1/odata/Relation_Organization({id})/Branch/$ref

Inline Relationship Updates

When creating or updating an organization, you can include related entities inline:

{
  "name": "Acme Corp",
  "emailAddress": "info@acmecorp.com",
  "VisitingAddress": {
    "street": "Keizersgracht 123",
    "city": "Amsterdam",
    "postalCode": "1015 AA",
    "country": "NL"
  }
}

You can also use binding links to reference existing entities:

{
  "name": "Acme Corp",
  "Branch@odata.bind": "Datastore_Branch(branch-id-here)"
}

Filtering Examples

GET/v1/odata/Relation_Organization?$filter=name eq '{name}'&$top={top}

GET/v1/odata/Relation_Organization?$filter=contains(name, '{name}')&$top={top}

GET/v1/odata/Relation_Organization?$filter=chamberOfCommerceNumber eq '{chamberOfCommerceNumber}'&$top={top}

GET/v1/odata/Relation_Organization?$filter=NumberOfEmployees gt {NumberOfEmployees}&$top={top}

GET/v1/odata/Relation_Organization?$filter=contains(name, '{name}') and numberOfEmployees gt {numberOfEmployees}&$top={top}

GET/v1/odata/Relation_Organization?$filter=contains(emailAddress, '{emailAddress}')&$top={top}

Data Enrichment

TribeCRM provides an AI-powered assistant endpoint for enriching organization data from external sources (BrandFetch, LinkedIn, Creditsafe, Google Maps).

POST/assistant/getOrganizationData