Company

List companies accessible to the caller

POST

https://api.gosmarter.ai

/api/me/companies

Returns all companies accessible to the caller, derived from the gateway-injected X-Groups header (Entra group GUIDs map to company IDs).

List companies accessible to the caller › Headers

GoSmarter-Api-Key

string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

List companies accessible to the caller › Responses

Companies retrieved successfully

companyDto[]

companyDto

createdAt

string · date-time

updatedAt

string · date-time

companyId

string · uuid

companyName

string

address

string

Get company stamp for branded certificates

GET

https://api.gosmarter.ai

/api/company/{companyId}/certificate-settings/stamp

Streams the stored company stamp. Returns 404 if no stamp has been uploaded.

Get company stamp for branded certificates › path Parameters

companyId

string · uuid · required

The unique identifier of the company

Get company stamp for branded certificates › Headers

GoSmarter-Api-Key

string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Get company stamp for branded certificates › Responses

Stamp image streamed successfully (PNG or JPEG, depending on the stored file)

string · binary

Upload company stamp for branded certificates

PUT

https://api.gosmarter.ai

/api/company/{companyId}/certificate-settings/stamp

Uploads a PNG or JPEG stamp (max 2 MB) for use in branded Material Test Certificate PDFs. Overwrites any existing stamp.

Upload company stamp for branded certificates › path Parameters

companyId

string · uuid · required

The unique identifier of the company

Upload company stamp for branded certificates › Headers

GoSmarter-Api-Key

string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Upload company stamp for branded certificates › Request Body

Upload company stamp for branded certificates › Responses

Stamp uploaded; updated settings returned

companyCertificateSettingsDto

companyId

string · uuid

logoStorageFileName

string

stampStorageFileName

string

stampText

string

certificateContactName

string

certificateContactEmail

string

certificateContactPhone

string

certificateFooterText

string

companyRegistrationNumber

string

createdAt

string · date-time

updatedAt

string · date-time

PUT/api/company/{companyId}/certificate-settings/stamp

curl https://api.gosmarter.ai/api/company/:companyId/certificate-settings/stamp \
  --request PUT \
  --header 'Content-Type: multipart/form-data' \
  --header 'GoSmarter-Api-Key: <string>' \
  --header 'Authorization: Bearer <token>'

Example Request Body

{}

text

Example Responses

{
  "companyId": "00000000-0000-0000-0000-000000000000",
  "logoStorageFileName": "logoStorageFileName",
  "stampStorageFileName": "stampStorageFileName",
  "stampText": "stampText",
  "certificateContactName": "certificateContactName",
  "certificateContactEmail": "certificateContactEmail",
  "certificateContactPhone": "certificateContactPhone",
  "certificateFooterText": "certificateFooterText",
  "companyRegistrationNumber": "companyRegistrationNumber",
  "createdAt": "2024-08-25T15:00:00Z",
  "updatedAt": "2024-08-25T15:00:00Z"
}

json

application/json

Delete company stamp for branded certificates

DELETE

https://api.gosmarter.ai

/api/company/{companyId}/certificate-settings/stamp

Removes the stored company stamp image and clears the accompanying stamp text. Idempotent; returns 200 even if no stamp was configured.

Delete company stamp for branded certificates › path Parameters

companyId

string · uuid · required

The unique identifier of the company

Delete company stamp for branded certificates › Headers

GoSmarter-Api-Key

string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Delete company stamp for branded certificates › Responses

Stamp removed; updated settings returned

companyCertificateSettingsDto

companyId

string · uuid

logoStorageFileName

string

stampStorageFileName

string

stampText

string

certificateContactName

string

certificateContactEmail

string

certificateContactPhone

string

certificateFooterText

string

companyRegistrationNumber

string

createdAt

string · date-time

updatedAt

string · date-time

DELETE/api/company/{companyId}/certificate-settings/stamp

curl https://api.gosmarter.ai/api/company/:companyId/certificate-settings/stamp \
  --request DELETE \
  --header 'GoSmarter-Api-Key: <string>' \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "companyId": "00000000-0000-0000-0000-000000000000",
  "logoStorageFileName": "logoStorageFileName",
  "stampStorageFileName": "stampStorageFileName",
  "stampText": "stampText",
  "certificateContactName": "certificateContactName",
  "certificateContactEmail": "certificateContactEmail",
  "certificateContactPhone": "certificateContactPhone",
  "certificateFooterText": "certificateFooterText",
  "companyRegistrationNumber": "companyRegistrationNumber",
  "createdAt": "2024-08-25T15:00:00Z",
  "updatedAt": "2024-08-25T15:00:00Z"
}

json

application/json

Get a company by ID

GET

https://api.gosmarter.ai

/api/company/{companyId}

Retrieves detailed information about a specific company

Get a company by ID › path Parameters

companyId

string · uuid · required

The unique identifier of the company. Example: 11111111-2222-3333-4444-555555555555

Get a company by ID › Headers

GoSmarter-Api-Key

string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Get a company by ID › Responses

Company details retrieved successfully

companyDto

createdAt

string · date-time

updatedAt

string · date-time

companyId

string · uuid

companyName

string

address

string

Update a company

PUT

https://api.gosmarter.ai

/api/company/{companyId}

Updates an existing company's information

Update a company › path Parameters

companyId

string · uuid · required

The unique identifier of the company to update. Example: 11111111-2222-3333-4444-555555555555

Update a company › Headers

GoSmarter-Api-Key

string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Update a company › Request Body

coreCompanyDto

companyId

string · uuid

companyName

string

address

string

Update a company › Responses

Company update accepted

coreCompanyDto

companyId

string · uuid

companyName

string

address

string

Get company logo for branded certificates

GET

https://api.gosmarter.ai

/api/company/{companyId}/certificate-settings/logo

Streams the stored company logo. Returns 404 if no logo has been uploaded.

Get company logo for branded certificates › path Parameters

companyId

string · uuid · required

The unique identifier of the company

Get company logo for branded certificates › Headers

GoSmarter-Api-Key

string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Get company logo for branded certificates › Responses

Logo image streamed successfully

string · binary

Upload company logo for branded certificates

PUT

https://api.gosmarter.ai

/api/company/{companyId}/certificate-settings/logo

Uploads a PNG or JPEG logo (max 2 MB) for use in branded Material Test Certificate PDFs. Overwrites any existing logo.

Upload company logo for branded certificates › path Parameters

companyId

string · uuid · required

The unique identifier of the company

Upload company logo for branded certificates › Headers

GoSmarter-Api-Key

string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Upload company logo for branded certificates › Request Body

Upload company logo for branded certificates › Responses

Logo uploaded; updated settings returned

companyCertificateSettingsDto

companyId

string · uuid

logoStorageFileName

string

stampStorageFileName

string

stampText

string

certificateContactName

string

certificateContactEmail

string

certificateContactPhone

string

certificateFooterText

string

companyRegistrationNumber

string

createdAt

string · date-time

updatedAt

string · date-time

PUT/api/company/{companyId}/certificate-settings/logo

curl https://api.gosmarter.ai/api/company/:companyId/certificate-settings/logo \
  --request PUT \
  --header 'Content-Type: multipart/form-data' \
  --header 'GoSmarter-Api-Key: <string>' \
  --header 'Authorization: Bearer <token>'

Example Request Body

{}

text

Example Responses

{
  "companyId": "00000000-0000-0000-0000-000000000000",
  "logoStorageFileName": "logoStorageFileName",
  "stampStorageFileName": "stampStorageFileName",
  "stampText": "stampText",
  "certificateContactName": "certificateContactName",
  "certificateContactEmail": "certificateContactEmail",
  "certificateContactPhone": "certificateContactPhone",
  "certificateFooterText": "certificateFooterText",
  "companyRegistrationNumber": "companyRegistrationNumber",
  "createdAt": "2024-08-25T15:00:00Z",
  "updatedAt": "2024-08-25T15:00:00Z"
}

json

application/json

Get certificate branding settings

GET

https://api.gosmarter.ai

/api/company/{companyId}/certificate-settings

Returns the company's certificate branding configuration used when generating branded Material Test Certificate PDFs

Get certificate branding settings › path Parameters

companyId

string · uuid · required

The unique identifier of the company

Get certificate branding settings › Headers

GoSmarter-Api-Key

string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Get certificate branding settings › Responses

Certificate settings retrieved (all fields may be null if not yet configured)

companyCertificateSettingsDto

companyId

string · uuid

logoStorageFileName

string

stampStorageFileName

string

stampText

string

certificateContactName

string

certificateContactEmail

string

certificateContactPhone

string

certificateFooterText

string

companyRegistrationNumber

string

createdAt

string · date-time

updatedAt

string · date-time

GET/api/company/{companyId}/certificate-settings

curl https://api.gosmarter.ai/api/company/:companyId/certificate-settings \
  --header 'GoSmarter-Api-Key: <string>' \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "companyId": "00000000-0000-0000-0000-000000000000",
  "logoStorageFileName": "logoStorageFileName",
  "stampStorageFileName": "stampStorageFileName",
  "stampText": "stampText",
  "certificateContactName": "certificateContactName",
  "certificateContactEmail": "certificateContactEmail",
  "certificateContactPhone": "certificateContactPhone",
  "certificateFooterText": "certificateFooterText",
  "companyRegistrationNumber": "companyRegistrationNumber",
  "createdAt": "2024-08-25T15:00:00Z",
  "updatedAt": "2024-08-25T15:00:00Z"
}

json

application/json

Update certificate branding settings

PATCH

https://api.gosmarter.ai

/api/company/{companyId}/certificate-settings

Updates the company's certificate branding configuration. Logo is managed separately via the logo upload endpoint. This endpoint does not affect the stored logo. All fields should be supplied; pass null to clear a field.

Update certificate branding settings › path Parameters

companyId

string · uuid · required

The unique identifier of the company

Update certificate branding settings › Headers

GoSmarter-Api-Key

string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Update certificate branding settings › Request Body

updateCompanyCertificateSettingsRequest

stampText

string

certificateContactName

string

certificateContactEmail

string

certificateContactPhone

string

certificateFooterText

string

companyRegistrationNumber

string

Update certificate branding settings › Responses

Settings updated successfully

companyCertificateSettingsDto

companyId

string · uuid

logoStorageFileName

string

stampStorageFileName

string

stampText

string

certificateContactName

string

certificateContactEmail

string

certificateContactPhone

string

certificateFooterText

string

companyRegistrationNumber

string

createdAt

string · date-time

updatedAt

string · date-time

PATCH/api/company/{companyId}/certificate-settings

curl https://api.gosmarter.ai/api/company/:companyId/certificate-settings \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'GoSmarter-Api-Key: <string>' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "stampText": "stampText",
  "certificateContactName": "certificateContactName",
  "certificateContactEmail": "certificateContactEmail",
  "certificateContactPhone": "certificateContactPhone",
  "certificateFooterText": "certificateFooterText",
  "companyRegistrationNumber": "companyRegistrationNumber"
}'

Example Request Body

{
  "stampText": "stampText",
  "certificateContactName": "certificateContactName",
  "certificateContactEmail": "certificateContactEmail",
  "certificateContactPhone": "certificateContactPhone",
  "certificateFooterText": "certificateFooterText",
  "companyRegistrationNumber": "companyRegistrationNumber"
}

json

Example Responses

{
  "companyId": "00000000-0000-0000-0000-000000000000",
  "logoStorageFileName": "logoStorageFileName",
  "stampStorageFileName": "stampStorageFileName",
  "stampText": "stampText",
  "certificateContactName": "certificateContactName",
  "certificateContactEmail": "certificateContactEmail",
  "certificateContactPhone": "certificateContactPhone",
  "certificateFooterText": "certificateFooterText",
  "companyRegistrationNumber": "companyRegistrationNumber",
  "createdAt": "2024-08-25T15:00:00Z",
  "updatedAt": "2024-08-25T15:00:00Z"
}

json

application/json

List email domains

GET

https://api.gosmarter.ai

/api/company/{companyId}/email-domains

Returns all email domains registered for the company.

List email domains › path Parameters

companyId

string · uuid · required

The unique identifier of the company

List email domains › Headers

GoSmarter-Api-Key

string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

List email domains › Responses

Email domains retrieved successfully

companyEmailDomainDto[]

companyEmailDomainDto

companyEmailDomainId

string · uuid

companyId

string · uuid

emailDomain

string

active

boolean

lastModifiedBy

string · uuid

updatedAt

string · date-time

Add email domain

POST

https://api.gosmarter.ai

/api/company/{companyId}/email-domains

Registers an email domain for the company. The same domain may be registered to multiple companies.

Add email domain › path Parameters

companyId

string · uuid · required

The unique identifier of the company

Add email domain › Headers

GoSmarter-Api-Key

string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Add email domain › Request Body

createCompanyEmailDomainRequest

emailDomain

string

Add email domain › Responses

Domain registered successfully

companyEmailDomainDto

companyEmailDomainId

string · uuid

companyId

string · uuid

emailDomain

string

active

boolean

lastModifiedBy

string · uuid

updatedAt

string · date-time

Remove email domain

DELETE

https://api.gosmarter.ai

/api/company/{companyId}/email-domains/{domainId}

Soft-deletes an email domain registration from the company. The domain can be restored via the restore endpoint.

Remove email domain › path Parameters

companyId

string · uuid · required

The unique identifier of the company

domainId

string · uuid · required

The unique identifier of the email domain entry to remove

Remove email domain › Headers

GoSmarter-Api-Key

string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Remove email domain › Responses

Domain soft-deleted successfully

No data returned

Get email domain change history

GET

https://api.gosmarter.ai

/api/company/{companyId}/email-domains/{domainId}/history

Returns the full temporal audit history for a company email domain, most recent changes first.

Get email domain change history › path Parameters

companyId

string · uuid · required

The unique identifier of the company

domainId

string · uuid · required

The unique identifier of the email domain entry

Get email domain change history › Headers

GoSmarter-Api-Key

string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Get email domain change history › Responses

Audit history returned successfully

auditEventDto[]

auditEventDto

changedAt

string · date-time

changedById

string · uuid

changedByName

string

changeType

string

auditFieldChange[]

entityType

string

entityLabel

string

Restore email domain

POST

https://api.gosmarter.ai

/api/company/{companyId}/email-domains/{domainId}/restore

Restores a previously soft-deleted email domain registration for the company.

Restore email domain › path Parameters

companyId

string · uuid · required

The unique identifier of the company

domainId

string · uuid · required

The unique identifier of the email domain entry to restore

Restore email domain › Headers

GoSmarter-Api-Key

string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Restore email domain › Responses

Domain restored successfully

companyEmailDomainDto

companyEmailDomainId

string · uuid

companyId

string · uuid

emailDomain

string

active

boolean

lastModifiedBy

string · uuid

updatedAt

string · date-time

Me InventoryTags