Functions and purpose

The Company controller allows you to perform many operations on companies.

The Business Object that represents companies is the CompanyBO class.

The DTO (Data Transfer Object) used to represent the company data model is CompanyDTO

Security

This controller works under the system security rules and constraints.
For more details, refer to the Authentication section

Note

The following guidelines are intended to illustrate the features and features of this Web API controller.


Aliases

This controller can be invoked by other names besides the default one.

This means that, referring to the routing grammar ({schema}://{host}/api/{version}/{controller}/{details}/{action}/{id}?{querystring}) it is possible to use a different fragment for the {controller} component.

Below is the list of these aliases for the fragment {controller}, sorted by suggested preference of use.

AliasPath
Companies/api/v1/Companies
Company/api/v1/Company

Authentication

JWT Token

In order to invoke the REST API, it is necessary to obtain an authentication token via the appropriate service /Auth/Login

For more details, please see the appropriate section of the documentations.

Bearer Authentication

Bearer authentication (also called token authentication) is an HTTP authentication scheme that involves security tokens called bearer tokens.

For more details, please see the appropriate section of the documentations.

Identification of the calling application

Some of the REST API functions can only be used if (in addition to proper user authentication) a declaration of the calling application is also performed.

For more details, please see the appropriate section of the documentations.


Actions & Paths

These are the REST actions that can be performed via the Web API infrastructure.
The actions are grouped by "topic".
Click on a "topic" to view the different actions contained in it.

Each action corresponds to a method in the class of the Web API controller, and a set of routing paths that can be used to invoke it.

Explore by topics
Topic nameMost commonly used actions
CRUD
Multiple CRUD
Activities
Contacts
Documents
External References
Flow
Lists
Mailings
Misc
OData
Opportunities
Preview
Sub Locations
Swagger

GET: /api/v1/Company/

Routing template:

/api/{version}/Company/

Produces:

  • HTTP 200: Int64 as application/json
  • HTTP 200: Int64 as text/json
  • HTTP 200: Int64 as application/xml
  • HTTP 200: Int64 as text/plain
  • HTTP 200: Int64 as application/octet-stream

Response: 200 (Success) ApiActionResult

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


DELETE: /api/v1/Company/{id}

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

  • HTTP 200: Boolean as application/json
  • HTTP 200: Boolean as text/json
  • HTTP 200: Boolean as application/xml
  • HTTP 200: Boolean as text/plain
  • HTTP 200: Boolean as application/octet-stream

Response: 200 (Success) Boolean

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

Response: 200 (Success) CompanyDTO

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/Activities

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

Response: 200 (Success) ActivityDTO

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/Activities/Count

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

  • HTTP 200: Int64 as application/json
  • HTTP 200: Int64 as text/json
  • HTTP 200: Int64 as application/xml
  • HTTP 200: Int64 as text/plain
  • HTTP 200: Int64 as application/octet-stream

Response: 200 (Success) Int64

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/ActivitiesIds

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

  • HTTP 200: Int64 as application/json
  • HTTP 200: Int64 as text/json
  • HTTP 200: Int64 as application/xml
  • HTTP 200: Int64 as text/plain
  • HTTP 200: Int64 as application/octet-stream

Response: 200 (Success) Int64

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/Archive

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64
template string NO Query
request CompanyPrintableRequest NO Query

Produces:

  • HTTP 400: integer as application/json
  • HTTP 400: integer as text/json
  • HTTP 400: integer as application/xml
  • HTTP 400: integer as text/plain
  • HTTP 400: integer as application/octet-stream
  • HTTP 400: integer as text/xml

Response: 400 (Bad Request) integer

Samples

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/Contacts

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

Response: 200 (Success) ContactDTO

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/Contacts/Count

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

  • HTTP 200: Int64 as application/json
  • HTTP 200: Int64 as text/json
  • HTTP 200: Int64 as application/xml
  • HTTP 200: Int64 as text/plain
  • HTTP 200: Int64 as application/octet-stream

Response: 200 (Success) Int64

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/ContactsIds

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

  • HTTP 200: Int64 as application/json
  • HTTP 200: Int64 as text/json
  • HTTP 200: Int64 as application/xml
  • HTTP 200: Int64 as text/plain
  • HTTP 200: Int64 as application/octet-stream

Response: 200 (Success) Int64

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/Documents

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

Response: 200 (Success) StorageDTO

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/Documents/Count

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

  • HTTP 200: Int64 as application/json
  • HTTP 200: Int64 as text/json
  • HTTP 200: Int64 as application/xml
  • HTTP 200: Int64 as text/plain
  • HTTP 200: Int64 as application/octet-stream

Response: 200 (Success) Int64

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/DocumentsIds

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

  • HTTP 200: Int64 as application/json
  • HTTP 200: Int64 as text/json
  • HTTP 200: Int64 as application/xml
  • HTTP 200: Int64 as text/plain
  • HTTP 200: Int64 as application/octet-stream

Response: 200 (Success) Int64

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/Exists

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

  • HTTP 200: Boolean as application/json
  • HTTP 200: Boolean as text/json
  • HTTP 200: Boolean as application/xml
  • HTTP 200: Boolean as text/plain
  • HTTP 200: Boolean as application/octet-stream

Response: 200 (Success) Boolean

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/Flows

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

  • HTTP 200: FlowDTO as application/json
  • HTTP 200: FlowDTO as text/json
  • HTTP 200: FlowDTO as application/xml
  • HTTP 200: FlowDTO as text/plain
  • HTTP 200: FlowDTO as application/octet-stream

Response: 200 (Success) FlowDTO

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/Flows/Count

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

  • HTTP 200: Int64 as application/json
  • HTTP 200: Int64 as text/json
  • HTTP 200: Int64 as application/xml
  • HTTP 200: Int64 as text/plain
  • HTTP 200: Int64 as application/octet-stream

Response: 200 (Success) Int64

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/FlowsIds

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

  • HTTP 200: Int64 as application/json
  • HTTP 200: Int64 as text/json
  • HTTP 200: Int64 as application/xml
  • HTTP 200: Int64 as text/plain
  • HTTP 200: Int64 as application/octet-stream

Response: 200 (Success) Int64

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/FreeFields

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

Response: 200 (Success) FreeFieldsBOItemDTO

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/GetDownloadUrl

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64
template string NO Query
request CompanyPrintableRequest NO Query

Produces:

  • HTTP 400: string as application/json
  • HTTP 400: string as text/json
  • HTTP 400: string as application/xml
  • HTTP 400: string as text/plain
  • HTTP 400: string as application/octet-stream
  • HTTP 400: string as text/xml

Response: 400 (Bad Request) string

Samples

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/GetFull

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

Response: 200 (Success) CompanyDTO

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/GetHash

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

  • HTTP 200: String as application/json
  • HTTP 200: String as text/json
  • HTTP 200: String as application/xml
  • HTTP 200: String as text/plain
  • HTTP 200: String as application/octet-stream

Response: 200 (Success) String

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


POST: /api/v1/Company/{id}/HtmlPreview

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64
template string NO Query
request CompanyPrintableRequest NO Query

Produces:

  • HTTP 200: String as application/json
  • HTTP 200: String as text/json
  • HTTP 200: String as application/xml
  • HTTP 200: String as text/plain
  • HTTP 200: String as application/octet-stream

Response: 200 (Success) String

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/Humanize

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

Response: 200 (Success) CompanyDTO

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/Lists

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

  • HTTP 200: ListDTO as application/json
  • HTTP 200: ListDTO as text/json
  • HTTP 200: ListDTO as application/xml
  • HTTP 200: ListDTO as text/plain
  • HTTP 200: ListDTO as application/octet-stream

Response: 200 (Success) ListDTO

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/ListsCount

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

  • HTTP 200: Int64 as application/json
  • HTTP 200: Int64 as text/json
  • HTTP 200: Int64 as application/xml
  • HTTP 200: Int64 as text/plain
  • HTTP 200: Int64 as application/octet-stream

Response: 200 (Success) Int64

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/ListsIds

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

  • HTTP 200: Int64 as application/json
  • HTTP 200: Int64 as text/json
  • HTTP 200: Int64 as application/xml
  • HTTP 200: Int64 as text/plain
  • HTTP 200: Int64 as application/octet-stream

Response: 200 (Success) Int64

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/Location

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

  • HTTP 200: String as application/json
  • HTTP 200: String as text/json
  • HTTP 200: String as application/xml
  • HTTP 200: String as text/plain
  • HTTP 200: String as application/octet-stream

Response: 200 (Success) String

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/Mailings

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

Response: 200 (Success) MailingDeliveryDTO

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/MailingsCount

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

  • HTTP 200: Int64 as application/json
  • HTTP 200: Int64 as text/json
  • HTTP 200: Int64 as application/xml
  • HTTP 200: Int64 as text/plain
  • HTTP 200: Int64 as application/octet-stream

Response: 200 (Success) Int64

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/MailingsIds

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

  • HTTP 200: Int64 as application/json
  • HTTP 200: Int64 as text/json
  • HTTP 200: Int64 as application/xml
  • HTTP 200: Int64 as text/plain
  • HTTP 200: Int64 as application/octet-stream

Response: 200 (Success) Int64

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/Opportunities

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

Response: 200 (Success) OpportunityDTO

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/Opportunities/Count

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

  • HTTP 200: Int64 as application/json
  • HTTP 200: Int64 as text/json
  • HTTP 200: Int64 as application/xml
  • HTTP 200: Int64 as text/plain
  • HTTP 200: Int64 as application/octet-stream

Response: 200 (Success) Int64

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/OpportunitiesIds

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

  • HTTP 200: Int64 as application/json
  • HTTP 200: Int64 as text/json
  • HTTP 200: Int64 as application/xml
  • HTTP 200: Int64 as text/plain
  • HTTP 200: Int64 as application/octet-stream

Response: 200 (Success) Int64

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


DELETE: /api/v1/Company/{id}/Photo

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Response:

200 (Success)

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/Photo

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Response:

200 (Success)

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


POST: /api/v1/Company/{id}/Photo

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Consumes:

  • multipart/form-data

Response:

200 (Success)

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/Preview

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64
page integer NO Query
  • Default: 1
  • Format: int32
zoom integer NO Query
  • Default: 0
  • Format: int32
template string NO Query
request CompanyPrintableRequest NO Query

Response:

200 (Success)

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


POST: /api/v1/Company/{id}/Previews

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64
template string NO Query
request CompanyPrintableRequest NO Query

Produces:

Response: 400 (Bad Request) array of FilePreview

Samples

Download Postman collection sample

Try this !


PUT: /api/v1/Company/{id}/Recent

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

  • HTTP 200: Boolean as application/json
  • HTTP 200: Boolean as text/json
  • HTTP 200: Boolean as application/xml
  • HTTP 200: Boolean as text/plain
  • HTTP 200: Boolean as application/octet-stream

Response: 200 (Success) Boolean

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/SubLocations

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

Response: 200 (Success) CompanyDTO

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/SubLocations/Count

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

  • HTTP 200: Int64 as application/json
  • HTTP 200: Int64 as text/json
  • HTTP 200: Int64 as application/xml
  • HTTP 200: Int64 as text/plain
  • HTTP 200: Int64 as application/octet-stream

Response: 200 (Success) Int64

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/{id}/SubLocationsIds

Parameters:

NameTypeRequiredInFeatures
id integer YES Path
  • Format: int64

Produces:

  • HTTP 200: Int64 as application/json
  • HTTP 200: Int64 as text/json
  • HTTP 200: Int64 as application/xml
  • HTTP 200: Int64 as text/plain
  • HTTP 200: Int64 as application/octet-stream

Response: 200 (Success) Int64

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/Count

Parameters:

NameTypeRequiredInFeatures
filter string NO Query

Produces:

  • HTTP 200: Int32 as application/json
  • HTTP 200: Int32 as text/json
  • HTTP 200: Int32 as application/xml
  • HTTP 200: Int32 as text/plain
  • HTTP 200: Int32 as application/octet-stream

Response: 200 (Success) Int32

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


POST: /api/v1/Company/CreateOrUpdate

Routing template:

/api/{version}/Company/CreateOrUpdate

Consumes:

  • application/json
  • application/xml
  • text/plain
  • application/json-patch+json
  • text/json
  • application/*+json

Produces:

  • HTTP 200: Int64 as application/json
  • HTTP 200: Int64 as text/json
  • HTTP 200: Int64 as application/xml
  • HTTP 200: Int64 as text/plain
  • HTTP 200: Int64 as application/octet-stream

Response: 200 (Success) ApiActionResult

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


DELETE: /api/v1/Company/DeleteByExternalReference

Parameters:

NameTypeRequiredInFeatures
externalReference string NO Query

Produces:

  • HTTP 200: Boolean as application/json
  • HTTP 200: Boolean as text/json
  • HTTP 200: Boolean as application/xml
  • HTTP 200: Boolean as text/plain
  • HTTP 200: Boolean as application/octet-stream

Response: 200 (Success) Boolean

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/DeleteByExternalReference

Parameters:

NameTypeRequiredInFeatures
externalReference string NO Query

Produces:

  • HTTP 200: Boolean as application/json
  • HTTP 200: Boolean as text/json
  • HTTP 200: Boolean as application/xml
  • HTTP 200: Boolean as text/plain
  • HTTP 200: Boolean as application/octet-stream

Response: 200 (Success) Boolean

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/GetBoDeleteModes

Routing template:

/api/{version}/Company/GetBoDeleteModes

Produces:

Response: 200 (Success) array of BoDeleteMode

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/GetByExternalReference

Parameters:

NameTypeRequiredInFeatures
externalReference string NO Query

Produces:

Response: 200 (Success) CompanyDTO

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/GetIdsByExternalReference

Parameters:

NameTypeRequiredInFeatures
externalReference string NO Query
excludeDeletedItems boolean NO Query

Produces:

  • HTTP 200: Int64 as application/json
  • HTTP 200: Int64 as text/json
  • HTTP 200: Int64 as application/xml
  • HTTP 200: Int64 as text/plain
  • HTTP 200: Int64 as application/octet-stream

Response: 200 (Success) Int64

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


POST: /api/v1/Company/GetIdsMappedByExternalReference

Routing template:

/api/{version}/Company/GetIdsMappedByExternalReference

Consumes:

  • application/json
  • application/xml
  • text/plain
  • application/json-patch+json
  • text/json
  • application/*+json
  • text/xml
  • application/*+xml

Produces:

  • HTTP 200: Int64 as application/json
  • HTTP 200: Int64 as text/json
  • HTTP 200: Int64 as application/xml
  • HTTP 200: Int64 as text/plain
  • HTTP 200: Int64 as application/octet-stream

Response: 200 (Success) ApiActionResult

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


POST: /api/v1/Company/GetIdsNotMappedByExternalReference

Routing template:

/api/{version}/Company/GetIdsNotMappedByExternalReference

Consumes:

  • application/json
  • application/xml
  • text/plain
  • application/json-patch+json
  • text/json
  • application/*+json
  • text/xml
  • application/*+xml

Produces:

  • HTTP 200: Int64 as application/json
  • HTTP 200: Int64 as text/json
  • HTTP 200: Int64 as application/xml
  • HTTP 200: Int64 as text/plain
  • HTTP 200: Int64 as application/octet-stream

Response: 200 (Success) ApiActionResult

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


POST: /api/v1/Company/GetItemsMappedByExternalReference

Routing template:

/api/{version}/Company/GetItemsMappedByExternalReference

Consumes:

  • application/json
  • application/xml
  • text/plain
  • application/json-patch+json
  • text/json
  • application/*+json
  • text/xml
  • application/*+xml

Produces:

Response: 200 (Success) ApiActionResult

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


POST: /api/v1/Company/GetItemsNotMappedByExternalReference

Routing template:

/api/{version}/Company/GetItemsNotMappedByExternalReference

Consumes:

  • application/json
  • application/xml
  • text/plain
  • application/json-patch+json
  • text/json
  • application/*+json
  • text/xml
  • application/*+xml

Produces:

Response: 200 (Success) ApiActionResult

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/GetNewInstance

Routing template:

/api/{version}/Company/GetNewInstance

Produces:

Response: 200 (Success) CompanyDTO

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/GetPolymorphicSchema

Parameters:

NameTypeRequiredInFeatures
serializePropertiesAsDictionary boolean NO Query
  • Default: True
honorAcceptLanguageHeader boolean NO Query
  • Default: False
generateSample boolean NO Query
  • Default: False
sampleGenerationStrategy SampleGenerationStrategy NO Query
useExtensions boolean NO Query
  • Default: True
includeExplicitlyDeclaredVirtualProperties boolean NO Query
  • Default: False

Produces:

  • HTTP 400: object as application/json
  • HTTP 400: object as text/json
  • HTTP 400: object as application/xml
  • HTTP 400: object as text/plain
  • HTTP 400: object as application/octet-stream

Response: 400 (Bad Request) object

Samples

Download Postman collection sample

Try this !


GET: /api/v1/Company/GetSample

Parameters:

NameTypeRequiredInFeatures
force boolean NO Query
  • Default: False
sampleGenerationStrategy SampleGenerationStrategy NO Query
useExtensions boolean NO Query
  • Default: True

Produces:

  • HTTP 200: JObject as application/json
  • HTTP 200: JObject as text/json
  • HTTP 200: JObject as application/xml
  • HTTP 200: JObject as text/plain
  • HTTP 200: JObject as application/octet-stream

Response: 200 (Success) JObject

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/GetStandardSchema

Parameters:

NameTypeRequiredInFeatures
honorAcceptLanguageHeader boolean NO Query
  • Default: False

Produces:

  • HTTP 400: object as application/json
  • HTTP 400: object as text/json
  • HTTP 400: object as application/xml
  • HTTP 400: object as text/plain
  • HTTP 400: object as application/octet-stream

Response: 400 (Bad Request) object

Samples

Download Postman collection sample

Try this !


GET: /api/v1/Company/GetSwagger

Parameters:

NameTypeRequiredInFeatures
honorAcceptLanguageHeader boolean NO Query
  • Default: False
bestPracticeOnly boolean NO Query
  • Default: True

Produces:

  • HTTP 200: object as application/json
  • HTTP 200: object as text/json
  • HTTP 200: object as application/xml
  • HTTP 200: object as text/plain
  • HTTP 200: object as application/octet-stream

Response: 200 (Success) object

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/MapByExternalReference

Parameters:

NameTypeRequiredInFeatures
externalReference string NO Query
internalItemId integer NO Query
  • Format: int64

Response:

200 (Success)

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


DELETE: /api/v1/Company/MultipleDelete

Routing template:

/api/{version}/Company/MultipleDelete

Consumes:

  • application/json
  • application/xml
  • text/plain
  • application/json-patch+json
  • text/json
  • application/*+json
  • text/xml
  • application/*+xml

Produces:

Response: 200 (Success) ApiActionResult

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


POST: /api/v1/Company/MultipleDelete

Routing template:

/api/{version}/Company/MultipleDelete

Consumes:

  • application/json
  • application/xml
  • text/plain
  • application/json-patch+json
  • text/json
  • application/*+json
  • text/xml
  • application/*+xml

Produces:

Response: 200 (Success) ApiActionResult

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


POST: /api/v1/Company/MultipleExists

Routing template:

/api/{version}/Company/MultipleExists

Consumes:

  • application/json
  • application/xml
  • text/plain
  • application/json-patch+json
  • text/json
  • application/*+json
  • text/xml
  • application/*+xml

Produces:

Response: 200 (Success) ApiActionResult

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


POST: /api/v1/Company/MultipleGet

Routing template:

/api/{version}/Company/MultipleGet

Consumes:

  • application/json
  • application/xml
  • text/plain
  • application/json-patch+json
  • text/json
  • application/*+json
  • text/xml
  • application/*+xml

Produces:

Response: 200 (Success) ApiActionResult[]>

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/PrintableFields

Parameters:

NameTypeRequiredInFeatures
includeFull boolean NO Query
  • Default: True
includeNesting boolean NO Query
  • Default: True

Produces:

Response: 400 (Bad Request) array of LiquidStruct

Samples

Download Postman collection sample

Try this !


GET: /api/v1/Company/ResetExternalReferences

Parameters:

NameTypeRequiredInFeatures
internalItemId integer NO Query
  • Format: int64

Response:

200 (Success)

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/ResolveCustomerToken

Parameters:

NameTypeRequiredInFeatures
token string NO Query

Produces:

  • HTTP 200: integer as application/json
  • HTTP 200: integer as text/json
  • HTTP 200: integer as application/xml
  • HTTP 200: integer as text/plain
  • HTTP 200: integer as application/octet-stream
  • HTTP 200: integer as text/xml

Response: 200 (Success) integer

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/Search

Parameters:

NameTypeRequiredInFeatures
filter string NO Query
orderBy string NO Query
skip integer NO Query
  • Format: int64
top integer NO Query
  • Format: int64
select string NO Query

Produces:

Response: 200 (Success) CompanyDTO

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/SearchIds

Parameters:

NameTypeRequiredInFeatures
filter string NO Query
orderBy string NO Query
skip integer NO Query
  • Format: int64
top integer NO Query
  • Format: int64

Produces:

  • HTTP 200: Int64 as application/json
  • HTTP 200: Int64 as text/json
  • HTTP 200: Int64 as application/xml
  • HTTP 200: Int64 as text/plain
  • HTTP 200: Int64 as application/octet-stream

Response: 200 (Success) Int64

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/SearchIdsByExternalReference

Parameters:

NameTypeRequiredInFeatures
externalReference string NO Query

Produces:

  • HTTP 200: Int64 as application/json
  • HTTP 200: Int64 as text/json
  • HTTP 200: Int64 as application/xml
  • HTTP 200: Int64 as text/plain
  • HTTP 200: Int64 as application/octet-stream

Response: 200 (Success) Int64

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !


GET: /api/v1/Company/Templates

Routing template:

/api/{version}/Company/Templates

Produces:

  • HTTP 400: array of string as application/json
  • HTTP 400: array of string as text/json
  • HTTP 400: array of string as application/xml
  • HTTP 400: array of string as text/plain
  • HTTP 400: array of string as application/octet-stream
  • HTTP 400: array of string as text/xml

Response: 400 (Bad Request) array of string

Samples

Download Postman collection sample

Try this !


GET: /api/v1/Company/UnmapByExternalReference

Parameters:

NameTypeRequiredInFeatures
externalReference string NO Query
internalItemId integer NO Query
  • Format: int64

Response:

200 (Success)

Samples

Download HTTP 200 response sample

Download Postman collection sample

Try this !



Definitions

The following definitions describe the structure of the datamodels involved in the various REST operations that can be performed for this controller.

Some definitions are subjected to polymorphic serialization, and therefore their complete polymorphic scheme is reported.

NameDescription
ActionResultDTOAction Result
ActivityBOActivityRelationDTOActivity BO Activity Relation
ActivityBOHourBandDTOActivity BO Hour Band
ActivityCostBOPriceDetailDTOActivity Cost BO Price Detail
ActivityDTOActivity
ActivityEMailDataDTOActivity EMail Data
ActivityFaxDataDTOActivity Fax Data
ActivityPrioritiesActivity Priorities
ActivitySourceActivity Source
ActivityStatesActivity States
ActivityTypeActivity Type
AddressAccuracyAddress Accuracy
AddressDTOAddress
AddressesListDTOAddresses List
AlarmActionTypeAlarm Action Type
AlarmDTOAlarm
AlarmNotificationDTOAlarm Notification
AlarmTimeValueTypeAlarm Time Value Type
AnagraphicStatusAnagraphic Status
ApprovedStatusApproved Status
BoDeleteModeBo Delete Mode
BusinessObjectTypeBusiness Object Type
CompanyDTOCompany
CompanyPrintableRequestCompany Printable Request
ContactDTOContact
ContactOtherCompanyDTOContact Other Company
CRMTablesCRM Tables
CrossActivityWithCross Activity With
CrossTypeCross Type
DefaultCodeTypeDefault Code Type
DefaultDocumentCategoriesDefault Document Categories
DeleteItemResultDelete Item Result
DirectionDTODirection
DTOPropertyUsageDTO Property Usage
EMailNormalizedDTOEMail Normalized
EMailNormalizeTypeEMail Normalize Type
ExistsItemResultExists Item Result
ExternalReferenceDTOExternal Reference
FileCrossAttributesFile Cross Attributes
FileCrossDTOFile Cross
FileCrossTypesFile Cross Types
FilePreviewFile Preview
FlowDTOFlow
FlowLinkDTOFlow Link
FlowLogDTOFlow Log
FlowStepResultFlow Step Result
FreeFieldsBOItemDTOFree Fields BO Item
FreeFieldsBOItemLocalizingDTOFree Fields BO Item Localizing
FreeFieldsBOTreeItemDTOFree Fields BO Tree Item
FreeFieldsTypeFree Fields Type
GenderGender
GeoDTOGeo
GetIdsMappedByExternalReferenceRequestGet Ids Mapped By External Reference Request
GetItemResult`1[]Get Item Result`1
GetItemsMappedByExternalReferenceRequestGet Items Mapped By External Reference Request
GravityGravity
InfluencerRoleTypeInfluencer Role Type
JTokenJ Token
LinkItemLink Item
LiquidStructLiquid Struct
ListDTOList
ListMailingListRightsDTOList Mailing List Rights
LocalizeTypeLocalize Type
LocalizingDTOLocalizing
LocationDTOLocation
MailAddressDTOMail Address
MailingDeliveryDTOMailing Delivery
MailingListRightsDTOMailing List Rights
MailListStatusMail List Status
MultipleDeleteModelMultiple Delete Model
MultipleExistsModelMultiple Exists Model
MultipleGetModelMultiple Get Model
NormalizerNormalizeAddressDTONormalizer Normalize Address
NormalizerNormalizeCityDTONormalizer Normalize City
OpportunityCompetitorDTOOpportunity Competitor
OpportunityDTOOpportunity
OpportunityPartnerDTOOpportunity Partner
OpportunityProductDTOOpportunity Product
OpportunityReferrerDTOOpportunity Referrer
OpportunityRefStatusTypeOpportunity Ref Status Type
OpportunityStatusOpportunity Status
PaymentCrossDTOPayment Cross
PhoneNormalizedDTOPhone Normalized
PhoneNormalizeTypePhone Normalize Type
PrivacyActivityMotivationImplicitConsentDTOPrivacy Activity Motivation Implicit Consent
PrivacyManagementDTOPrivacy Management
PrivacyTypeManagementDTOPrivacy Type Management
RelationDTORelation
SampleGenerationStrategySample Generation Strategy
ServiceCrossTypeService Cross Type
SharePermissionDTOShare Permission
SharingDTOSharing
ShippedByShipped By
StorageDTOStorage
StoragePermissionStorage Permission
SyncPropertyFlagSync Property Flag
TargetListCrossTypeTarget List Cross Type
ToDoStatesTo Do States
TypePrivacyType Privacy

Errors

The controller actions will generate errors for the following cases:

  • Status 400: Badly formed queries e.g. filter parameters that are not correctly encoded
  • Status 401: Authentication failures e.g. unrecognised keys
  • Status 403: Forbidden. The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource, or may need an account of some sort.
  • Status 404: Not found. Unknown resources e.g. data which is not public
  • Status 409: Conflict. Indicates that the request could not be processed because of conflict in the current state of the resource, such as an edit conflict between multiple simultaneous updates.
  • Status 500: Server errors e.g. where something has gone

Errors are formatted in JSON


Versioning

It is possible to select the web services version using the {version} token

/api/{version}/{controller}/{details}/{action}/{id}?{querystring}

The token {version} can contain both "exact" values ​​and the special "latest" alias, which identifies the most recent version among those existing in the system.

In general, the use of the special "latest" alias is strongly recommended.

If you want to be particularly "conservative" and adherent to a specific version, specify the name explicitly (eg "v1").


Routing

The system use the following routing syntax, consisting of a sequence of "path-tokens" (the request parameters):

{schema}://{host}/api/{version}/{controller}/{details}/{action}/{id}?{querystring}

The tokens identify respectively:

  • {host} -> HOST of the URL
  • {version} -> version of web services
  • {controller} -> name of the service (controller) you want to invoke
  • {details} -> optional detail level of the returned JSON (if applicable)
  • {action} -> optional action (method) invoked in the controller
  • {id} -> single optional primary key argument (parameter) of the method in the controller, if it so requires
  • {querystring} -> additional parameters and possible "modifiers" of the processing and serialization process


OData

The REST APIs are internally based on the Microsoft WebAPI technology, and are largely compliant with the REST specifications, OData v3 and OData v4.

Functions and details related to OData

For more details and specifications regarding the general criteria to adopt when using the OData functions, refer to the basic guide on the topic


Options

The REST API functions implemented in CRM in Cloud include a vast set of options that allow you to adapt the structure and shape of JSON packages according to your needs and preferences.

Unlike the parameters, which are specified in the URL route (through tokens and querystring), the options must instead be passed through the HTTP headers of the request.

As from RFC6648 all the options passed through HTTP headers have in their name the custom prefix "Crm-".

If a certain option is not specified, the system will use the default value specific to the {version} indicated in the URL.

For a complete discussion of options and polymorphic serialization, refer to the general guide on the subject


Swagger

Below you can download the JSON descriptor in Swagger/OpenAPI format

Download Swagger descriptor