StreamlineAppearance
Create Company Profile.
Endpoint for creating company profile.
Endpoints
| Environment | API Endpoint |
|---|---|
| Sandbox | https://onprem-test.streamline.laboremus.ug/api/crm/routing/v1/profiles/companies |
Request
Request Type : POST
Authorization
There are two ways to be authorized when making this request.
js
const token = 'eyJhbGciOiJIUzI1NiIsInR5.eyJzd...ssw5c'
axios.get(API_ENDPOINT,
headers: {
Authorization: `Bearer ${token}`
}
)const token = 'eyJhbGciOiJIUzI1NiIsInR5.eyJzd...ssw5c'
axios.get(API_ENDPOINT,
headers: {
Authorization: `Bearer ${token}`
}
)js
import axios from 'axios'
import oauth from 'axios-oauth-client'
const getClientCredentials = oauth.clientCredentials(
axios.create(),
'https://oauth.com/2.0/token',
'CLIENT_ID',
'CLIENT_SECRET'
)
const auth = await getClientCredentials('OPTIONAL_SCOPES')
// => { "access_token": "...", "expires_in": 900, ... }
axios.get(API_ENDPOINT,
headers: {
Authorization: `Bearer ${auth.access_token}`
}
)import axios from 'axios'
import oauth from 'axios-oauth-client'
const getClientCredentials = oauth.clientCredentials(
axios.create(),
'https://oauth.com/2.0/token',
'CLIENT_ID',
'CLIENT_SECRET'
)
const auth = await getClientCredentials('OPTIONAL_SCOPES')
// => { "access_token": "...", "expires_in": 900, ... }
axios.get(API_ENDPOINT,
headers: {
Authorization: `Bearer ${auth.access_token}`
}
)INFO
Always add your Subscription key to the request.
js
axios.post(API_ENDPOINT,
headers: {
'Ocp-Apim-Subscription-Key': 'd484a1f0d34f4301916d0f2c9e9106a2'
}
)axios.post(API_ENDPOINT,
headers: {
'Ocp-Apim-Subscription-Key': 'd484a1f0d34f4301916d0f2c9e9106a2'
}
)js
const res = await axios.post(API_ENDPOINT, {
params: {
Ocp-Apim-Subscription-Key: 'd484a1f0d34f4301916d0f2c9e9106a2'
}
});const res = await axios.post(API_ENDPOINT, {
params: {
Ocp-Apim-Subscription-Key: 'd484a1f0d34f4301916d0f2c9e9106a2'
}
});Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| v | string | no | The version of the API |
Request Body
Example Request Body
json
{
"tenantId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"profileId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"applicationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"companyName": "string",
"companyType": "string",
"registrationNumber": "string",
"incorporationDate": "string",
"email": "string",
"phoneNumbers": [
{
"number": "string",
"isPrimary": true
}
],
"addresses": [
{
"country": "string",
"category": "Home",
"street": "string",
"plotNumber": "string",
"town": "string",
"district": "string",
"county": "string",
"subcounty": "string",
"parish": "string",
"village": "string"
}
],
"taxPayerDetails": [
{
"tin": "string",
"taxPayerName": "string"
}
],
"shareHolders": [
{
"fullName": "string",
"uniqueId": "string",
"phoneNumber": "string",
"nationality": "string",
"type": "Person",
"shares": "string"
}
],
"directors": [
{
"fullName": "string",
"uniqueId": "string",
"phoneNumber": "string",
"nationality": "string",
"type": "Person",
"shares": "string"
}
],
"partners": [
{
"fullName": "string",
"uniqueId": "string",
"phoneNumber": "string",
"nationality": "string",
"type": "Person",
"shares": "string"
}
],
"secretary": [
{
"fullName": "string",
"uniqueId": "string",
"phoneNumber": "string",
"nationality": "string",
"type": "Person",
"shares": "string"
}
],
"subscribers": [
{
"fullName": "string",
"uniqueId": "string",
"phoneNumber": "string",
"nationality": "string",
"type": "Person",
"shares": "string"
}
],
"kccaTradeLicenseDetails": [
{
"referenceNumber": "string",
"typeOfReferenceNumber": "string",
"entityName": "string"
}
]
}{
"tenantId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"profileId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"applicationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"companyName": "string",
"companyType": "string",
"registrationNumber": "string",
"incorporationDate": "string",
"email": "string",
"phoneNumbers": [
{
"number": "string",
"isPrimary": true
}
],
"addresses": [
{
"country": "string",
"category": "Home",
"street": "string",
"plotNumber": "string",
"town": "string",
"district": "string",
"county": "string",
"subcounty": "string",
"parish": "string",
"village": "string"
}
],
"taxPayerDetails": [
{
"tin": "string",
"taxPayerName": "string"
}
],
"shareHolders": [
{
"fullName": "string",
"uniqueId": "string",
"phoneNumber": "string",
"nationality": "string",
"type": "Person",
"shares": "string"
}
],
"directors": [
{
"fullName": "string",
"uniqueId": "string",
"phoneNumber": "string",
"nationality": "string",
"type": "Person",
"shares": "string"
}
],
"partners": [
{
"fullName": "string",
"uniqueId": "string",
"phoneNumber": "string",
"nationality": "string",
"type": "Person",
"shares": "string"
}
],
"secretary": [
{
"fullName": "string",
"uniqueId": "string",
"phoneNumber": "string",
"nationality": "string",
"type": "Person",
"shares": "string"
}
],
"subscribers": [
{
"fullName": "string",
"uniqueId": "string",
"phoneNumber": "string",
"nationality": "string",
"type": "Person",
"shares": "string"
}
],
"kccaTradeLicenseDetails": [
{
"referenceNumber": "string",
"typeOfReferenceNumber": "string",
"entityName": "string"
}
]
}Response
Response Body
Content type
application/json
Company Details
| Name | Type | Description |
|---|---|---|
| id | string (uuid) | A unique identifier for the company record. |
| createdAt | string (ISO 8601) | The date and time the company was created. |
| lastUpdated | string (ISO 8601) | The date and time the company was last updated. |
| tenantId | string (uuid) | The tenant ID associated with the company. |
| applicationId | string (uuid) | A unique application identifier for the company. |
| companyName | string | The name of the company. |
| companyType | string | The type of company (e.g., private, public). |
| registrationNumber | string | The company’s registration number. |
| incorporationDate | string (ISO 8601) | The date the company was incorporated. |
| string | The company’s email address. |
Phone Numbers
| Name | Type | Description |
|---|---|---|
| id | string (uuid) | A unique identifier for the phone number record. |
| createdAt | string (ISO 8601) | The date and time the phone number record was created. |
| lastUpdated | string (ISO 8601) | The date and time the phone number record was last updated. |
| number | string | The company’s phone number. |
| isPrimary | boolean | Indicates if the phone number is the primary contact. |
Addresses
| Name | Type | Description |
|---|---|---|
| id | string (uuid) | A unique identifier for the address record. |
| createdAt | string (ISO 8601) | The date and time the address record was created. |
| lastUpdated | string (ISO 8601) | The date and time the address record was last updated. |
| country | string | The country in which the company is located. |
| type | string | The type of address (e.g., Home, Office). |
| town | string | The town or city in which the company is located. |
| district | string | The district where the company is located. |
| county | string | The county of the company's address. |
| subCounty | string | The sub-county of the company's address. |
| parish | string | The parish of the company’s address. |
| village | string | The village where the company is located. |
| isPrimary | boolean | Indicates if the address is the primary address. |
Taxpayer Details
| Name | Type | Description |
|---|---|---|
| id | string (uuid) | A unique identifier for the tax payer record. |
| createdAt | string (ISO 8601) | The date and time the tax payer details were created. |
| lastUpdated | string (ISO 8601) | The date and time the tax payer details were last updated. |
| tin | string | The Tax Identification Number (TIN) of the company. |
| taxPayerName | string | The name of the tax payer. |
Shareholders, Directors, Partners, Secretary, and Subscribers
| Name | Type | Description |
|---|---|---|
| fullName | string | The full name of the individual. |
| uniqueId | string | A unique identifier for the individual. |
| phoneNumber | string | The individual’s phone number. |
| nationality | string | The nationality of the individual. |
| type | string | The type of role the individual holds (e.g., shareholder, director). |
| shares | string | The number of shares held by the individual. |
KCCA Trade License Details
| Name | Type | Description |
|---|---|---|
| id | string (uuid) | A unique identifier for the trade license record. |
| createdAt | string (ISO 8601) | The date and time the trade license record was created. |
| lastUpdated | string (ISO 8601) | The date and time the trade license record was last updated. |
| referenceNumber | string | The reference number for the trade license. |
| typeOfReferenceNumber | string | The type of reference number (e.g., registration, license). |
| entityName | string | The name of the entity holding the trade license. |
Documents
| Name | Type | Description |
|---|---|---|
| id | string (uuid) | A unique identifier for the document. |
| name | string | The name of the document. |
| documentType | string | The type of document (e.g., passport, ID). |
| description | string | A brief description of the document. |
| contentType | string | The content type of the document (e.g., image/jpeg). |
| size | string | The size of the document. |
| reference | string | The reference ID of the document. |
| dateCreated | string (ISO 8601) | The date and time the document was created. |
Example Response Body
json
[
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"createdAt": "2024-10-01T12:28:19.049Z",
"lastUpdated": "2024-10-01T12:28:19.049Z",
"tenantId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"applicationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"companyName": "string",
"companyType": "string",
"registrationNumber": "string",
"incorporationDate": "string",
"email": "string",
"phoneNumbers": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"createdAt": "2024-10-01T12:28:19.049Z",
"lastUpdated": "2024-10-01T12:28:19.049Z",
"number": "string",
"isPrimary": true
}
],
"addresses": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"createdAt": "2024-10-01T12:28:19.049Z",
"lastUpdated": "2024-10-01T12:28:19.049Z",
"country": "string",
"type": "Home",
"town": "string",
"district": "string",
"county": "string",
"subCounty": "string",
"parish": "string",
"village": "string",
"isPrimary": true
}
],
"taxPayerDetails": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"createdAt": "2024-10-01T12:28:19.049Z",
"lastUpdated": "2024-10-01T12:28:19.049Z",
"tin": "string",
"taxPayerName": "string"
}
],
"shareHolders": [
{
"fullName": "string",
"uniqueId": "string",
"phoneNumber": "string",
"nationality": "string",
"type": "string",
"shares": "string"
}
],
"directors": [
{
"fullName": "string",
"uniqueId": "string",
"phoneNumber": "string",
"nationality": "string",
"type": "string",
"shares": "string"
}
],
"partners": [
{
"fullName": "string",
"uniqueId": "string",
"phoneNumber": "string",
"nationality": "string",
"type": "string",
"shares": "string"
}
],
"secretary": [
{
"fullName": "string",
"uniqueId": "string",
"phoneNumber": "string",
"nationality": "string",
"type": "string",
"shares": "string"
}
],
"kccaTradeLicenseDetails": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"createdAt": "2024-10-01T12:28:19.049Z",
"lastUpdated": "2024-10-01T12:28:19.049Z",
"referenceNumber": "string",
"typeOfReferenceNumber": "string",
"entityName": "string"
}
],
"subscribers": [
{
"fullName": "string",
"uniqueId": "string",
"phoneNumber": "string",
"nationality": "string",
"type": "string",
"shares": "string"
}
],
"documents": [
{
"id": "string",
"name": "string",
"documentType": "string",
"description": "string",
"contentType": "string",
"size": "string",
"reference": "string",
"dateCreated": "2024-10-01T12:28:19.050Z"
}
]
}
][
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"createdAt": "2024-10-01T12:28:19.049Z",
"lastUpdated": "2024-10-01T12:28:19.049Z",
"tenantId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"applicationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"companyName": "string",
"companyType": "string",
"registrationNumber": "string",
"incorporationDate": "string",
"email": "string",
"phoneNumbers": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"createdAt": "2024-10-01T12:28:19.049Z",
"lastUpdated": "2024-10-01T12:28:19.049Z",
"number": "string",
"isPrimary": true
}
],
"addresses": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"createdAt": "2024-10-01T12:28:19.049Z",
"lastUpdated": "2024-10-01T12:28:19.049Z",
"country": "string",
"type": "Home",
"town": "string",
"district": "string",
"county": "string",
"subCounty": "string",
"parish": "string",
"village": "string",
"isPrimary": true
}
],
"taxPayerDetails": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"createdAt": "2024-10-01T12:28:19.049Z",
"lastUpdated": "2024-10-01T12:28:19.049Z",
"tin": "string",
"taxPayerName": "string"
}
],
"shareHolders": [
{
"fullName": "string",
"uniqueId": "string",
"phoneNumber": "string",
"nationality": "string",
"type": "string",
"shares": "string"
}
],
"directors": [
{
"fullName": "string",
"uniqueId": "string",
"phoneNumber": "string",
"nationality": "string",
"type": "string",
"shares": "string"
}
],
"partners": [
{
"fullName": "string",
"uniqueId": "string",
"phoneNumber": "string",
"nationality": "string",
"type": "string",
"shares": "string"
}
],
"secretary": [
{
"fullName": "string",
"uniqueId": "string",
"phoneNumber": "string",
"nationality": "string",
"type": "string",
"shares": "string"
}
],
"kccaTradeLicenseDetails": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"createdAt": "2024-10-01T12:28:19.049Z",
"lastUpdated": "2024-10-01T12:28:19.049Z",
"referenceNumber": "string",
"typeOfReferenceNumber": "string",
"entityName": "string"
}
],
"subscribers": [
{
"fullName": "string",
"uniqueId": "string",
"phoneNumber": "string",
"nationality": "string",
"type": "string",
"shares": "string"
}
],
"documents": [
{
"id": "string",
"name": "string",
"documentType": "string",
"description": "string",
"contentType": "string",
"size": "string",
"reference": "string",
"dateCreated": "2024-10-01T12:28:19.050Z"
}
]
}
]