Get multiple Contacts
Read the data for multiple Contacts.
A Contact is an individual or business for which you want to maintain information in the Alliant system. A Contact can represent a Participant or Recipient in a Contract, can be associated with a Participant in a Contract, can represent a guild, and so forth. For example, you can set up a Contact that represents the accountant for a Participant, and add this Contact as a Statement Recipient to the Recipient Group for the Participant in a Contract. You can use the Alliant system to maintain information regarding Contact names, addresses, company names, and so forth.
query Parameters
Success
Bad Request
Forbidden
Not Found
Method Not Allowed
Internal Server Error
- 200
- 400
- 403
- 404
- 405
- 500
{- "result": {
- "previousPageUrl": "string",
- "nextPageUrl": "string",
- "itemCount": 1,
- "totalItemCount": 20,
- "items": [
- {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "addressVersionNumber": 0,
- "adminClassReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "aliasVersionNumber": 0,
- "comment": "string",
- "companyName": "string",
- "contactTypeReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "deliveryGroupVersionNumber": 0,
- "emailVersionNumber": 0,
- "fileSystemVersionNumber": 0,
- "firstName": "string",
- "formattedName": "string",
- "hasFileSystemAddressFlag": true,
- "holdDeliveryFlag": true,
- "id": "string",
- "isAlliantUserFlag": true,
- "keywordVersionNumber": 0,
- "lastName": "string",
- "middleName": "string",
- "modifiedByUserReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "modifiedDatetime": "2019-08-24T14:15:22Z",
- "namePrefix": "string",
- "nameSuffix": "string",
- "noteSID": 0,
- "participantFlag": true,
- "recipientVersionNumber": 0,
- "sid": 1,
- "sortByName": "string",
- "statusReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "systemModifiedDatetime": "2019-08-24T14:15:22Z",
- "udfVersionNumber": 0,
- "userReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "verifiedFlag": true,
- "versionNumber": 0
}
]
}, - "errors": [ ],
- "warnings": [ ],
- "hasErrors": false,
- "hasWarnings": false
}
Create a new Contact
A Contact is an individual or business for which you want to maintain information in the Alliant system. A Contact can represent a Participant or Recipient in a Contract, can be associated with a Participant in a Contract, can represent a guild, and so forth. For example, you can set up a Contact that represents the accountant for a Participant, and add this Contact as a Statement Recipient to the Recipient Group for the Participant in a Contract. You can use the Alliant system to maintain information regarding Contact names, addresses, company names, and so forth.
When you want to create a Contact with Recipient Groups, if you simply want to default the contact to be its own recipient as part of your POST
, simply include:
"contactRecipientGroups": [
{
"_action": "add",
"contactRecipientGroupDetails": [
{
"_action": "add"
}
]
}
],
"contactAddresses": [
{
"_action": "add",
"addressTypeReference": {
"displayName": "Business"
},
"countryReference": {
"displayName": "United States of America"
},
"stateReference": {
"displayName": "Iowa"
},
"city": "1",
"postalCode": "1"
}
]
}
When you want to create a Contact with a linked Adjustment, you must first submit a POST Request to create the Contact. You must then submit a PUT or PATCH Request to update the Contact with the Adjustment information.
The id
and sortByName
properties are required. The formattedName
property is also required; however, when any of following properties are provided, Alliant API generates a value the formattedName
property when it is not provided: firstName
, lastName
, middleName
, namePrefix
, nameSuffix
, or companyName
.
query Parameters
minimal | boolean When you specify this Verbosity parameter, the |
default | boolean Use this Verbosity parameter option when you want Alliant API to return a response that includes all properties for the Item, including UD Fields. This is the default option that is used when no Verbosity parameter is provided. |
verbose | boolean Use this Verbosity parameter option when you want Alliant API to return UD Field Lookups, Adjustments on Tab, Child Collection, and Cross-Reference properties in addition to the properties from the default Verbosity level. Note: Using this parameter may affect performance and should only be used when necessary. |
include | string Use this Verbosity parameter to specify the properties to include in the response, separated by commas. You can also specify that you want to include Adjustments on Tab, Cross-Reference data Items, Child Items, and Child fields in the response. When you set the Verbosity of the response to minimal or default, Items only display as much information as the Verbosity parameter allows. You can use the ChildDataItem.ChildPropertyName syntax to specify when you want to return additional Child properties. Note: When the values specified in the include parameter are not valid, the query parameter is ignored and a warning is added to response includes property1, childItem1 child collection, childProperty2 of childItem2 collection, udLookup_UDField1 UD Field lookup collection. include=property1,childItem1,childItem2.childProperty2,udLookup_UDField1 |
exclude | string Use this Verbosity parameter to specify the properties to exclude from the response, separated by commas. You can also specify that you want to exclude Adjustments on Tab, Cross-Reference data Items, Child Items, and Child fields from the response. You can use the ChildDataItem.ChildPropertyName syntax to specify when you want to exclude specific Child properties. Note: When the values specified in the exclude parameter are not valid, the query parameter is ignored and a warning is added to response includes all properies according to Verbosity parameter, except for property1, childItem1 collection, childProperty2 of childItem2 collection, and udLookup_UDField1 UD Field lookup collection. exclude=property1,childItem1,childItem2.childProperty2,udLookup_UDField1 |
contextReplace | string Use this parameter to specify the properties with context replaced values in the response, separated by commas. You can also specify that you want to context replace values for all properties by specifying all. Note: When the values specified in the contextReplace parameter are not valid, the query parameter is ignored. displayName and ud_UDField1 properties in the response have context replaced values. contextReplace=displayName,ud_UDField1All properties in the response have context replaced values. contextReplace=all |
autoLogOff | boolean Use the autoLogOff parameter to log off Alliant API, discard the Alliant session Security Token, and release the Alliant license currently in use by Alliant API once the request completes. |
Request Body schema: application/jsonrequired
Include as much information as possible regarding the Contact
ID (object) or description (object) or SID (object) or GUID (object) (Admin Class) Specify the Admin Class for the Contact. | |
comment | string (Comment) <= 1000 characters Specify the Comment for the Contact, when applicable. |
companyName | string <= 60 characters Specify the Company Name for the Contact, when applicable. |
Array of objects (Contact Physical Addresses Child Collection Request) Contact Physical Addresses | |
Array of objects (Attachments Child Collection Request) Contact Attachments | |
Array of objects (Contact Delivery Groups Child Collection Request) Contact Delivery Groups | |
Array of objects (Contact E-mail Addresses Child Collection Request) Contact E-mail Addresses | |
Array of objects (Contact File System Addresses Child Collection Request) Contact File System Addresses. The required properties vary based on the | |
Array of objects (Keywords Child Collection Request) Contact Keywords | |
Array of objects (Links Child Collection Request) Contact Links | |
Array of objects (Notes Child Collection Request) Contact Notes | |
Array of objects (Reminders Child Collection Request) Contact Reminders. The required properties vary based on the | |
ID (object) or description (object) or SID (object) or GUID (object) (Reference) Specify the Contact Type for the Contact. | |
firstName | string <= 60 characters Specify the first name for the Contact. |
formattedName required | string [ 1 .. 255 ] characters Specify the Full Name for the Contact. The Full Name contains the text you entered in the Prefix, First Name, Middle Name, Last Name, Suffix, and Company Name fields, in that order. |
hasFileSystemAddressFlag | boolean (Flag) Specify whether the Contact can have File System Addresses. |
holdDeliveryFlag | boolean (Flag) Specify whether to hold Deliveries for this Contact. |
id required | string (ID) [ 1 .. 60 ] characters unique Specify the unique system ID for the Contact. |
lastName | string <= 60 characters Specify the last name for the Contact. |
middleName | string <= 60 characters Specify the middle name for the Contact. |
namePrefix | string <= 20 characters Specify the prefix for the Contact. |
nameSuffix | string <= 15 characters Specify the suffix for the Contact. |
participantFlag | boolean (Flag) Specify whether the Contact is a Participant. Only those Contacts that are specified as Participants are available for selection as a Participant for a Contract. |
sortByName required | string [ 1 .. 255 ] characters Specify the Sort By Name for the Contact. The Sort By Name contains the text you entered in the Last Name, Prefix, First Name, Middle Name, Suffix, and Company Name fields, in that order. |
ud_userDefinedStringField | string (ud_userDefinedStringField_Request) Specify values for the single-value string UD Fields for the Item, when applicable. These UD Fields use the name of the UD Field prefixed with |
ud_userDefinedNumberField | number (ud_userDefinedNumberField_Request) Specify values for the single-value numerical UD Fields for the Item, when applicable. These UD Fields use the name of the UD Field prefixed with |
ID (string) or description (string) or SID (number) or GUID (string) (ud_userDefinedReferenceRequest) Single-value Reference UD Fields for an Item are included in the collection with the Name of the UD Field prefixed with | |
object (udLookup_LookupUDFieldRequest) When you send a POST or PUT request for an Item that includes a Lookup UD Field and you want to modify the Lookup UD Field data, use the | |
Array of objects (Contact Recipient Groups Child Collection POST Request) Contact Recipient Groups When you want to create a Contact with Recipient Groups, you must first submit a POST Request to create the Contact with the Recipient Groups, but without Recipient Group Details. You must then submit a PUT or PATCH Request to update the Recipient Groups with the necessary Recipient Group Details. |
Created
Bad Request
Forbidden
Not Found
Method Not Allowed
Conflict
Internal Server Error
- Payload
{- "comment": "New Contact",
- "companyName": "RST",
- "contactAddresses": [
- {
- "_action": "add",
- "address1": "124 Elm St",
- "addressTypeReference": {
- "guid": "16ce9863-67b1-478e-a840-1a38deef6ca4"
}, - "attentionFlag": false,
- "careOfFlag": false,
- "city": "Woodland Hills",
- "comment": "Contact Address Comment",
- "countryReference": {
- "guid": "cd37d2b9-9043-440d-9c6e-23e806a9b14f"
}, - "displayName": "Home Address",
- "formattedAddress": "124 Elm St, Woodland Hills, CA, 91364",
- "postalCode": "91364",
- "stateReference": {
- "guid": "d99b34cc-bc97-46bc-8bdb-68e2240c9d29"
}, - "useAsPrimaryFlag": true
}
], - "contactDeliveryGroups": [
- {
- "_action": "add",
- "comment": "New Delivery Group",
- "contactDeliveryGroupDetails": [
- {
- "_action": "add",
- "deliverToContactReference": {
- "guid": "553E493D-7E9F-482F-87BE-F45A84220135"
}, - "deliveryMethodReference": {
- "guid": "4234DB71-62A2-46CF-AF72-59A4A9EDB4A7"
}, - "emailTypeReference": {
- "guid": "478f26d0-912d-456f-a5d8-ea8fca798468"
}
}
], - "deliveryGroupReference": {
- "guid": "a57c9ed0-93d6-46b7-b812-502c80f7f9d9"
}, - "holdDeliveryFlag": false
}
], - "contactRecipientGroups": [
- {
- "_action": "add",
- "comment": "New Contact Recipient Group",
- "description": "New Contact Recipient Group",
- "displayName": "New Contact Recipient Group"
}
], - "contactTypeReference": {
- "guid": "80aa8953-a823-494c-88a7-34b05e63711d"
}, - "firstName": "New",
- "formattedName": "Test, New Contact",
- "hasFileSystemAddressFlag": false,
- "holdDeliveryFlag": false,
- "id": "NewContactCreatedByAPI",
- "isAlliantUserFlag": false,
- "lastName": "Test",
- "middleName": "Contact",
- "participantFlag": true,
- "sortByName": "Test, New Contact"
}
- 201
- 400
- 403
- 404
- 405
- 409
- 500
{- "result": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "addressVersionNumber": 0,
- "adminClassReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "aliasVersionNumber": 0,
- "comment": "string",
- "companyName": "string",
- "contactTypeReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "deliveryGroupVersionNumber": 0,
- "emailVersionNumber": 0,
- "fileSystemVersionNumber": 0,
- "firstName": "string",
- "formattedName": "string",
- "hasFileSystemAddressFlag": true,
- "holdDeliveryFlag": true,
- "id": "string",
- "isAlliantUserFlag": true,
- "keywordVersionNumber": 0,
- "lastName": "string",
- "middleName": "string",
- "modifiedByUserReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "modifiedDatetime": "2019-08-24T14:15:22Z",
- "namePrefix": "string",
- "nameSuffix": "string",
- "noteSID": 0,
- "participantFlag": true,
- "recipientVersionNumber": 0,
- "sid": 1,
- "sortByName": "string",
- "statusReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "systemModifiedDatetime": "2019-08-24T14:15:22Z",
- "udfVersionNumber": 0,
- "userReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "verifiedFlag": true,
- "versionNumber": 0
}, - "errors": [
- { }
], - "warnings": [
- { }
], - "hasErrors": false,
- "hasWarnings": false
}
Get a single Contact
Read the data for a specific Contact.
A Contact is an individual or business for which you want to maintain information in the Alliant system. A Contact can represent a Participant or Recipient in a Contract, can be associated with a Participant in a Contract, can represent a guild, and so forth. For example, you can set up a Contact that represents the accountant for a Participant, and add this Contact as a Statement Recipient to the Recipient Group for the Participant in a Contract. You can use the Alliant system to maintain information regarding Contact names, addresses, company names, and so forth.
query Parameters
downloadAttachments | boolean Use the downloadAttachments parameter to include Attachment data in the response. You must include either the verbose parameter or the include={ItemType}Attachments parameter when you want to include Attachment data in the response. Attachment data is returned in the _data property in base64 encoded format. When you do not include the downloadAttachments parameter but you include the verbose parameter or the include={ItemType}Attachments parameter, you can use the value in the the |
minimal | boolean When you specify this Verbosity parameter, the |
default | boolean Use this Verbosity parameter option when you want Alliant API to return a response that includes all properties for the Item, including UD Fields. This is the default option that is used when no Verbosity parameter is provided. |
verbose | boolean Use this Verbosity parameter option when you want Alliant API to return UD Field Lookups, Adjustments on Tab, Child Collection, and Cross-Reference properties in addition to the properties from the default Verbosity level. Note: Using this parameter may affect performance and should only be used when necessary. |
include | string Use this Verbosity parameter to specify the properties to include in the response, separated by commas. You can also specify that you want to include Adjustments on Tab, Cross-Reference data Items, Child Items, and Child fields in the response. When you set the Verbosity of the response to minimal or default, Items only display as much information as the Verbosity parameter allows. You can use the ChildDataItem.ChildPropertyName syntax to specify when you want to return additional Child properties. Note: When the values specified in the include parameter are not valid, the query parameter is ignored and a warning is added to response includes property1, childItem1 child collection, childProperty2 of childItem2 collection, udLookup_UDField1 UD Field lookup collection. include=property1,childItem1,childItem2.childProperty2,udLookup_UDField1 |
exclude | string Use this Verbosity parameter to specify the properties to exclude from the response, separated by commas. You can also specify that you want to exclude Adjustments on Tab, Cross-Reference data Items, Child Items, and Child fields from the response. You can use the ChildDataItem.ChildPropertyName syntax to specify when you want to exclude specific Child properties. Note: When the values specified in the exclude parameter are not valid, the query parameter is ignored and a warning is added to response includes all properies according to Verbosity parameter, except for property1, childItem1 collection, childProperty2 of childItem2 collection, and udLookup_UDField1 UD Field lookup collection. exclude=property1,childItem1,childItem2.childProperty2,udLookup_UDField1 |
contextReplace | string Use this parameter to specify the properties with context replaced values in the response, separated by commas. You can also specify that you want to context replace values for all properties by specifying all. Note: When the values specified in the contextReplace parameter are not valid, the query parameter is ignored. displayName and ud_UDField1 properties in the response have context replaced values. contextReplace=displayName,ud_UDField1All properties in the response have context replaced values. contextReplace=all |
getWarnings | boolean When you specify this parameter, warning validation messages are returned. |
autoLogOff | boolean Use the autoLogOff parameter to log off Alliant API, discard the Alliant session Security Token, and release the Alliant license currently in use by Alliant API once the request completes. |
Successful Operation
Forbidden
Not Found
Method Not Allowed
Internal Server Error
- 200
- 403
- 404
- 405
- 500
{- "result": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "addressVersionNumber": 0,
- "adminClassReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "aliasVersionNumber": 0,
- "comment": "string",
- "companyName": "string",
- "contactTypeReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "deliveryGroupVersionNumber": 0,
- "emailVersionNumber": 0,
- "fileSystemVersionNumber": 0,
- "firstName": "string",
- "formattedName": "string",
- "hasFileSystemAddressFlag": true,
- "holdDeliveryFlag": true,
- "id": "string",
- "isAlliantUserFlag": true,
- "keywordVersionNumber": 0,
- "lastName": "string",
- "middleName": "string",
- "modifiedByUserReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "modifiedDatetime": "2019-08-24T14:15:22Z",
- "namePrefix": "string",
- "nameSuffix": "string",
- "noteSID": 0,
- "participantFlag": true,
- "recipientVersionNumber": 0,
- "sid": 1,
- "sortByName": "string",
- "statusReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "systemModifiedDatetime": "2019-08-24T14:15:22Z",
- "udfVersionNumber": 0,
- "userReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "verifiedFlag": true,
- "versionNumber": 0
}, - "errors": [
- { }
], - "warnings": [
- { }
], - "hasErrors": false,
- "hasWarnings": false
}
Delete a Contact
Delete a specific Contact.
A Contact is an individual or business for which you want to maintain information in the Alliant system. A Contact can represent a Participant or Recipient in a Contract, can be associated with a Participant in a Contract, can represent a guild, and so forth. For example, you can set up a Contact that represents the accountant for a Participant, and add this Contact as a Statement Recipient to the Recipient Group for the Participant in a Contract. You can use the Alliant system to maintain information regarding Contact names, addresses, company names, and so forth.
OK
Forbidden
Method Not Allowed
Conflict
Internal Server Error
- 200
- 403
- 405
- 409
- 500
{- "result": null,
- "errors": [ ],
- "warnings": [ ],
- "hasErrors": false,
- "hasWarnings": false
}
Update a Contact
A Contact is an individual or business for which you want to maintain information in the Alliant system. A Contact can represent a Participant or Recipient in a Contract, can be associated with a Participant in a Contract, can represent a guild, and so forth. For example, you can set up a Contact that represents the accountant for a Participant, and add this Contact as a Statement Recipient to the Recipient Group for the Participant in a Contract. You can use the Alliant system to maintain information regarding Contact names, addresses, company names, and so forth.
The request body that you submit should include all of the properties that you want to update. When you want to update a UD Field Lookup Item, Child Data Item, Cross-Reference Item, or Adjustments on Tab Item, you must specify a value for the _action
subproperty. The following actions are available for UD Field Lookup Items, Child Data Items, and Adjustments on Tab:
· add – specify this action when you want to add a new Item.
· delete – specify this action when you want to delete an Item.
· update – specify this action when you want to update data for an Item.
The following actions are available for Cross-Reference Items:
· add – specify this action when you want to add a Cross-Reference Item.
· update – specify this action when you want to update data for a Cross-Reference Item.
When you want to create a Contact with a linked Adjustment, you must first submit a POST Request to create the Contact. You must then submit a PUT or PATCH Request to update the Contact with the Adjustment information.
Note: When you submit a request to add or delete Child or Cross-reference Items, the request is not idempotent. When you specify an _action
value for a Child or Cross-reference Item, the action supercedes the behaviour indicated by the HTTP verb for the Child or Cross-reference Item. In this scenario, the request is similar to an HTTP PATCH request.
query Parameters
minimal | boolean When you specify this Verbosity parameter, the |
default | boolean Use this Verbosity parameter option when you want Alliant API to return a response that includes all properties for the Item, including UD Fields. This is the default option that is used when no Verbosity parameter is provided. |
verbose | boolean Use this Verbosity parameter option when you want Alliant API to return UD Field Lookups, Adjustments on Tab, Child Collection, and Cross-Reference properties in addition to the properties from the default Verbosity level. Note: Using this parameter may affect performance and should only be used when necessary. |
include | string Use this Verbosity parameter to specify the properties to include in the response, separated by commas. You can also specify that you want to include Adjustments on Tab, Cross-Reference data Items, Child Items, and Child fields in the response. When you set the Verbosity of the response to minimal or default, Items only display as much information as the Verbosity parameter allows. You can use the ChildDataItem.ChildPropertyName syntax to specify when you want to return additional Child properties. Note: When the values specified in the include parameter are not valid, the query parameter is ignored and a warning is added to response includes property1, childItem1 child collection, childProperty2 of childItem2 collection, udLookup_UDField1 UD Field lookup collection. include=property1,childItem1,childItem2.childProperty2,udLookup_UDField1 |
exclude | string Use this Verbosity parameter to specify the properties to exclude from the response, separated by commas. You can also specify that you want to exclude Adjustments on Tab, Cross-Reference data Items, Child Items, and Child fields from the response. You can use the ChildDataItem.ChildPropertyName syntax to specify when you want to exclude specific Child properties. Note: When the values specified in the exclude parameter are not valid, the query parameter is ignored and a warning is added to response includes all properies according to Verbosity parameter, except for property1, childItem1 collection, childProperty2 of childItem2 collection, and udLookup_UDField1 UD Field lookup collection. exclude=property1,childItem1,childItem2.childProperty2,udLookup_UDField1 |
contextReplace | string Use this parameter to specify the properties with context replaced values in the response, separated by commas. You can also specify that you want to context replace values for all properties by specifying all. Note: When the values specified in the contextReplace parameter are not valid, the query parameter is ignored. displayName and ud_UDField1 properties in the response have context replaced values. contextReplace=displayName,ud_UDField1All properties in the response have context replaced values. contextReplace=all |
forceTimestampValidation | boolean Use the forceTimestampValidation parameter to validate the Timestamp for the Items that you want to update. When you use this parameter, you must include the following in the request body:
|
autoLogOff | boolean Use the autoLogOff parameter to log off Alliant API, discard the Alliant session Security Token, and release the Alliant license currently in use by Alliant API once the request completes. |
Request Body schema: application/jsonrequired
Include as much information as possible regarding the Contact
ID (object) or description (object) or SID (object) or GUID (object) (Admin Class) Specify the Admin Class for the Contact. | |
comment | string (Comment) <= 1000 characters Specify the Comment for the Contact, when applicable. |
companyName | string <= 60 characters Specify the Company Name for the Contact, when applicable. |
Array of objects (Contact Physical Addresses Child Collection Request) Contact Physical Addresses | |
Array of objects (Attachments Child Collection Request) Contact Attachments | |
Array of objects (Contact Delivery Groups Child Collection Request) Contact Delivery Groups | |
Array of objects (Contact E-mail Addresses Child Collection Request) Contact E-mail Addresses | |
Array of objects (Contact File System Addresses Child Collection Request) Contact File System Addresses. The required properties vary based on the | |
Array of objects (Keywords Child Collection Request) Contact Keywords | |
Array of objects (Links Child Collection Request) Contact Links | |
Array of objects (Notes Child Collection Request) Contact Notes | |
Array of objects (Reminders Child Collection Request) Contact Reminders. The required properties vary based on the | |
ID (object) or description (object) or SID (object) or GUID (object) (Reference) Specify the Contact Type for the Contact. | |
firstName | string <= 60 characters Specify the first name for the Contact. |
formattedName | string [ 1 .. 255 ] characters Specify the Full Name for the Contact. The Full Name contains the text you entered in the Prefix, First Name, Middle Name, Last Name, Suffix, and Company Name fields, in that order. |
hasFileSystemAddressFlag | boolean (Flag) Specify whether the Contact can have File System Addresses. |
holdDeliveryFlag | boolean (Flag) Specify whether to hold Deliveries for this Contact. |
id | string (ID) [ 1 .. 60 ] characters unique Specify the unique system ID for the Contact. |
lastName | string <= 60 characters Specify the last name for the Contact. |
middleName | string <= 60 characters Specify the middle name for the Contact. |
namePrefix | string <= 20 characters Specify the prefix for the Contact. |
nameSuffix | string <= 15 characters Specify the suffix for the Contact. |
participantFlag | boolean (Flag) Specify whether the Contact is a Participant. Only those Contacts that are specified as Participants are available for selection as a Participant for a Contract. |
sortByName | string [ 1 .. 255 ] characters Specify the Sort By Name for the Contact. The Sort By Name contains the text you entered in the Last Name, Prefix, First Name, Middle Name, Suffix, and Company Name fields, in that order. |
ud_userDefinedStringField | string (ud_userDefinedStringField_Request) Specify values for the single-value string UD Fields for the Item, when applicable. These UD Fields use the name of the UD Field prefixed with |
ud_userDefinedNumberField | number (ud_userDefinedNumberField_Request) Specify values for the single-value numerical UD Fields for the Item, when applicable. These UD Fields use the name of the UD Field prefixed with |
ID (string) or description (string) or SID (number) or GUID (string) (ud_userDefinedReferenceRequest) Single-value Reference UD Fields for an Item are included in the collection with the Name of the UD Field prefixed with | |
object (udLookup_LookupUDFieldRequest) When you send a POST or PUT request for an Item that includes a Lookup UD Field and you want to modify the Lookup UD Field data, use the | |
Array of objects (Contact Recipient Groups Child Collection PUT Request) Contact Recipient Groups When you want to create a Contact with Recipient Groups, you must first submit a POST Request to create the Contact with the Recipient Groups, but without Recipient Group Details. You must then submit a PUT or PATCH Request to update the Recipient Groups with the necessary Recipient Group Details. | |
Array of objects (Adjustment Cross-reference Request Properties) Contact Adjustments When you want to create a Contact with a linked Adjustment, you must first submit a POST Request to create the Contact. You must then submit a PUT or PATCH Request to update the Contact with the Adjustment information. The required properties vary based on the |
OK
Bad Request
Forbidden
Not Found
Method Not Allowed
Conflict
Unsupported Media Type
Internal Server Error
- Payload
{- "adminClassReference": {
- "id": "Clients"
}, - "comment": "Client Contact",
- "companyName": "Rightsline",
- "contactTypeReference": {
- "id": "Clients"
}, - "displayName": "John Holder",
- "firstName": "John",
- "formattedName": "John Holder",
- "hasFileSystemAddressFlag": false,
- "holdDeliveryFlag": false,
- "id": "JHolder",
- "isAlliantUserFlag": false,
- "lastName": "Holder",
- "middleName": "Anthony",
- "namePrefix": "Mr.",
- "participantFlag": true,
- "sortByName": "Holder, John"
}
- 200
- 400
- 403
- 404
- 405
- 409
- 415
- 500
{- "result": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "addressVersionNumber": 0,
- "adminClassReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "aliasVersionNumber": 0,
- "comment": "string",
- "companyName": "string",
- "contactTypeReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "deliveryGroupVersionNumber": 0,
- "emailVersionNumber": 0,
- "fileSystemVersionNumber": 0,
- "firstName": "string",
- "formattedName": "string",
- "hasFileSystemAddressFlag": true,
- "holdDeliveryFlag": true,
- "id": "string",
- "isAlliantUserFlag": true,
- "keywordVersionNumber": 0,
- "lastName": "string",
- "middleName": "string",
- "modifiedByUserReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "modifiedDatetime": "2019-08-24T14:15:22Z",
- "namePrefix": "string",
- "nameSuffix": "string",
- "noteSID": 0,
- "participantFlag": true,
- "recipientVersionNumber": 0,
- "sid": 1,
- "sortByName": "string",
- "statusReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "systemModifiedDatetime": "2019-08-24T14:15:22Z",
- "udfVersionNumber": 0,
- "userReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "verifiedFlag": true,
- "versionNumber": 0
}, - "errors": [
- { }
], - "warnings": [
- { }
], - "hasErrors": false,
- "hasWarnings": false
}
Update a Contact
Update the data for a specific Contact.
A Contact is an individual or business for which you want to maintain information in the Alliant system. A Contact can represent a Participant or Recipient in a Contract, can be associated with a Participant in a Contract, can represent a guild, and so forth. For example, you can set up a Contact that represents the accountant for a Participant, and add this Contact as a Statement Recipient to the Recipient Group for the Participant in a Contract. You can use the Alliant system to maintain information regarding Contact names, addresses, company names, and so forth.
The request body that you submit should include all of the properties that you want to update. When you want to update a UD Field Lookup Item, Child Data Item, Cross-Reference Item, or Adjustments on Tab Item, you must specify a value for the _action
subproperty. The following actions are available for UD Field Lookup Items, Child Data Items, and Adjustments on Tab:
· add – specify this action when you want to add a new Item.
· delete – specify this action when you want to delete an Item.
· update – specify this action when you want to update data for an Item.
The following actions are available for Cross-Reference Items:
· add – specify this action when you want to add a Cross-Reference Item.
· update – specify this action when you want to update data for a Cross-Reference Item.
When you want to create a Contact with Recipient Groups, you must first submit a POST Request to create the Contact with the Recipient Groups, but without Recipient Group Details. You must then submit a PUT or PATCH Request to update the Recipient Groups with the necessary Recipient Group Details.
When you want to create a Contact with a linked Adjustment, you must first submit a POST Request to create the Contact. You must then submit a PUT or PATCH Request to update the Contact with the Adjustment information.
Note: As well as partial updates, it is possible to use an _action
to add or delete records. When there is an _action included within the body, then this action supercedes the behaviour indicated by the HTTP verb.
query Parameters
minimal | boolean When you specify this Verbosity parameter, the |
default | boolean Use this Verbosity parameter option when you want Alliant API to return a response that includes all properties for the Item, including UD Fields. This is the default option that is used when no Verbosity parameter is provided. |
verbose | boolean Use this Verbosity parameter option when you want Alliant API to return UD Field Lookups, Adjustments on Tab, Child Collection, and Cross-Reference properties in addition to the properties from the default Verbosity level. Note: Using this parameter may affect performance and should only be used when necessary. |
include | string Use this Verbosity parameter to specify the properties to include in the response, separated by commas. You can also specify that you want to include Adjustments on Tab, Cross-Reference data Items, Child Items, and Child fields in the response. When you set the Verbosity of the response to minimal or default, Items only display as much information as the Verbosity parameter allows. You can use the ChildDataItem.ChildPropertyName syntax to specify when you want to return additional Child properties. Note: When the values specified in the include parameter are not valid, the query parameter is ignored and a warning is added to response includes property1, childItem1 child collection, childProperty2 of childItem2 collection, udLookup_UDField1 UD Field lookup collection. include=property1,childItem1,childItem2.childProperty2,udLookup_UDField1 |
exclude | string Use this Verbosity parameter to specify the properties to exclude from the response, separated by commas. You can also specify that you want to exclude Adjustments on Tab, Cross-Reference data Items, Child Items, and Child fields from the response. You can use the ChildDataItem.ChildPropertyName syntax to specify when you want to exclude specific Child properties. Note: When the values specified in the exclude parameter are not valid, the query parameter is ignored and a warning is added to response includes all properies according to Verbosity parameter, except for property1, childItem1 collection, childProperty2 of childItem2 collection, and udLookup_UDField1 UD Field lookup collection. exclude=property1,childItem1,childItem2.childProperty2,udLookup_UDField1 |
contextReplace | string Use this parameter to specify the properties with context replaced values in the response, separated by commas. You can also specify that you want to context replace values for all properties by specifying all. Note: When the values specified in the contextReplace parameter are not valid, the query parameter is ignored. displayName and ud_UDField1 properties in the response have context replaced values. contextReplace=displayName,ud_UDField1All properties in the response have context replaced values. contextReplace=all |
forceTimestampValidation | boolean Use the forceTimestampValidation parameter to validate the Timestamp for the Items that you want to update. When you use this parameter, you must include the following in the request body:
|
autoLogOff | boolean Use the autoLogOff parameter to log off Alliant API, discard the Alliant session Security Token, and release the Alliant license currently in use by Alliant API once the request completes. |
Request Body schema: application/jsonrequired
Include as much information as possible regarding the Contact
ID (object) or description (object) or SID (object) or GUID (object) (Admin Class) Specify the Admin Class for the Contact. | |
comment | string (Comment) <= 1000 characters Specify the Comment for the Contact, when applicable. |
companyName | string <= 60 characters Specify the Company Name for the Contact, when applicable. |
Array of objects (Contact Physical Addresses Child Collection Request) Contact Physical Addresses | |
Array of objects (Attachments Child Collection Request) Contact Attachments | |
Array of objects (Contact Delivery Groups Child Collection Request) Contact Delivery Groups | |
Array of objects (Contact E-mail Addresses Child Collection Request) Contact E-mail Addresses | |
Array of objects (Contact File System Addresses Child Collection Request) Contact File System Addresses. The required properties vary based on the | |
Array of objects (Keywords Child Collection Request) Contact Keywords | |
Array of objects (Links Child Collection Request) Contact Links | |
Array of objects (Notes Child Collection Request) Contact Notes | |
Array of objects (Reminders Child Collection Request) Contact Reminders. The required properties vary based on the | |
ID (object) or description (object) or SID (object) or GUID (object) (Reference) Specify the Contact Type for the Contact. | |
firstName | string <= 60 characters Specify the first name for the Contact. |
formattedName | string [ 1 .. 255 ] characters Specify the Full Name for the Contact. The Full Name contains the text you entered in the Prefix, First Name, Middle Name, Last Name, Suffix, and Company Name fields, in that order. |
hasFileSystemAddressFlag | boolean (Flag) Specify whether the Contact can have File System Addresses. |
holdDeliveryFlag | boolean (Flag) Specify whether to hold Deliveries for this Contact. |
id | string (ID) [ 1 .. 60 ] characters unique Specify the unique system ID for the Contact. |
lastName | string <= 60 characters Specify the last name for the Contact. |
middleName | string <= 60 characters Specify the middle name for the Contact. |
namePrefix | string <= 20 characters Specify the prefix for the Contact. |
nameSuffix | string <= 15 characters Specify the suffix for the Contact. |
participantFlag | boolean (Flag) Specify whether the Contact is a Participant. Only those Contacts that are specified as Participants are available for selection as a Participant for a Contract. |
sortByName | string [ 1 .. 255 ] characters Specify the Sort By Name for the Contact. The Sort By Name contains the text you entered in the Last Name, Prefix, First Name, Middle Name, Suffix, and Company Name fields, in that order. |
ud_userDefinedStringField | string (ud_userDefinedStringField_Request) Specify values for the single-value string UD Fields for the Item, when applicable. These UD Fields use the name of the UD Field prefixed with |
ud_userDefinedNumberField | number (ud_userDefinedNumberField_Request) Specify values for the single-value numerical UD Fields for the Item, when applicable. These UD Fields use the name of the UD Field prefixed with |
ID (string) or description (string) or SID (number) or GUID (string) (ud_userDefinedReferenceRequest) Single-value Reference UD Fields for an Item are included in the collection with the Name of the UD Field prefixed with | |
object (udLookup_LookupUDFieldRequest) When you send a POST or PUT request for an Item that includes a Lookup UD Field and you want to modify the Lookup UD Field data, use the | |
Array of objects (Contact Recipient Groups Child Collection PUT Request) Contact Recipient Groups When you want to create a Contact with Recipient Groups, you must first submit a POST Request to create the Contact with the Recipient Groups, but without Recipient Group Details. You must then submit a PUT or PATCH Request to update the Recipient Groups with the necessary Recipient Group Details. | |
Array of objects (Adjustment Cross-reference Request Properties) Contact Adjustments When you want to create a Contact with a linked Adjustment, you must first submit a POST Request to create the Contact. You must then submit a PUT or PATCH Request to update the Contact with the Adjustment information. The required properties vary based on the |
OK
Bad Request
Forbidden
Not Found
Method Not Allowed
Conflict
Unsupported Media Type
Internal Server Error
- Payload
{- "adminClassReference": {
- "id": "Clients"
}, - "comment": "Client Contact",
- "companyName": "Rightsline",
- "contactTypeReference": {
- "id": "Clients"
}, - "displayName": "John Holder",
- "firstName": "John",
- "formattedName": "John Holder",
- "hasFileSystemAddressFlag": false,
- "holdDeliveryFlag": false,
- "id": "JHolder",
- "isAlliantUserFlag": false,
- "lastName": "Holder",
- "middleName": "Anthony",
- "namePrefix": "Mr.",
- "participantFlag": true,
- "sortByName": "Holder, John"
}
- 200
- 400
- 403
- 404
- 405
- 409
- 415
- 500
{- "result": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "addressVersionNumber": 0,
- "adminClassReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "aliasVersionNumber": 0,
- "comment": "string",
- "companyName": "string",
- "contactTypeReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "deliveryGroupVersionNumber": 0,
- "emailVersionNumber": 0,
- "fileSystemVersionNumber": 0,
- "firstName": "string",
- "formattedName": "string",
- "hasFileSystemAddressFlag": true,
- "holdDeliveryFlag": true,
- "id": "string",
- "isAlliantUserFlag": true,
- "keywordVersionNumber": 0,
- "lastName": "string",
- "middleName": "string",
- "modifiedByUserReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "modifiedDatetime": "2019-08-24T14:15:22Z",
- "namePrefix": "string",
- "nameSuffix": "string",
- "noteSID": 0,
- "participantFlag": true,
- "recipientVersionNumber": 0,
- "sid": 1,
- "sortByName": "string",
- "statusReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "systemModifiedDatetime": "2019-08-24T14:15:22Z",
- "udfVersionNumber": 0,
- "userReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "verifiedFlag": true,
- "versionNumber": 0
}, - "errors": [
- { }
], - "warnings": [
- { }
], - "hasErrors": false,
- "hasWarnings": false
}
Copy an existing Contact
Copy a specific Contact.
This PUT does not behave as a standard HTTP PUT and is NOT idempotent. This PUT will create a new resource. Its behaviour is that of a POST and it should be treated as such.
query Parameters
downloadAttachments | boolean Use the downloadAttachments parameter to include Attachment data in the response. You must include either the verbose parameter or the include={ItemType}Attachments parameter when you want to include Attachment data in the response. Attachment data is returned in the _data property in base64 encoded format. When you do not include the downloadAttachments parameter but you include the verbose parameter or the include={ItemType}Attachments parameter, you can use the value in the the |
minimal | boolean When you specify this Verbosity parameter, the |
default | boolean Use this Verbosity parameter option when you want Alliant API to return a response that includes all properties for the Item, including UD Fields. This is the default option that is used when no Verbosity parameter is provided. |
verbose | boolean Use this Verbosity parameter option when you want Alliant API to return UD Field Lookups, Adjustments on Tab, Child Collection, and Cross-Reference properties in addition to the properties from the default Verbosity level. Note: Using this parameter may affect performance and should only be used when necessary. |
include | string Use this Verbosity parameter to specify the properties to include in the response, separated by commas. You can also specify that you want to include Adjustments on Tab, Cross-Reference data Items, Child Items, and Child fields in the response. When you set the Verbosity of the response to minimal or default, Items only display as much information as the Verbosity parameter allows. You can use the ChildDataItem.ChildPropertyName syntax to specify when you want to return additional Child properties. Note: When the values specified in the include parameter are not valid, the query parameter is ignored and a warning is added to response includes property1, childItem1 child collection, childProperty2 of childItem2 collection, udLookup_UDField1 UD Field lookup collection. include=property1,childItem1,childItem2.childProperty2,udLookup_UDField1 |
exclude | string Use this Verbosity parameter to specify the properties to exclude from the response, separated by commas. You can also specify that you want to exclude Adjustments on Tab, Cross-Reference data Items, Child Items, and Child fields from the response. You can use the ChildDataItem.ChildPropertyName syntax to specify when you want to exclude specific Child properties. Note: When the values specified in the exclude parameter are not valid, the query parameter is ignored and a warning is added to response includes all properies according to Verbosity parameter, except for property1, childItem1 collection, childProperty2 of childItem2 collection, and udLookup_UDField1 UD Field lookup collection. exclude=property1,childItem1,childItem2.childProperty2,udLookup_UDField1 |
contextReplace | string Use this parameter to specify the properties with context replaced values in the response, separated by commas. You can also specify that you want to context replace values for all properties by specifying all. Note: When the values specified in the contextReplace parameter are not valid, the query parameter is ignored. displayName and ud_UDField1 properties in the response have context replaced values. contextReplace=displayName,ud_UDField1All properties in the response have context replaced values. contextReplace=all |
getWarnings | boolean When you specify this parameter, warning validation messages are returned. |
autoLogOff | boolean Use the autoLogOff parameter to log off Alliant API, discard the Alliant session Security Token, and release the Alliant license currently in use by Alliant API once the request completes. |
Request Body schema: application/json
Successful Operation
Forbidden
Not Found
Method Not Allowed
Unsupported Media Type
Internal Server Error
- Payload
{- "copyAdjustments": true,
- "copyNotes": true
}
- 200
- 403
- 404
- 405
- 415
- 500
{- "result": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "addressVersionNumber": 0,
- "adminClassReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "aliasVersionNumber": 0,
- "comment": "string",
- "companyName": "string",
- "contactTypeReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "deliveryGroupVersionNumber": 0,
- "emailVersionNumber": 0,
- "fileSystemVersionNumber": 0,
- "firstName": "string",
- "formattedName": "string",
- "hasFileSystemAddressFlag": true,
- "holdDeliveryFlag": true,
- "id": "string",
- "isAlliantUserFlag": true,
- "keywordVersionNumber": 0,
- "lastName": "string",
- "middleName": "string",
- "modifiedByUserReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "modifiedDatetime": "2019-08-24T14:15:22Z",
- "namePrefix": "string",
- "nameSuffix": "string",
- "noteSID": 0,
- "participantFlag": true,
- "recipientVersionNumber": 0,
- "sid": 1,
- "sortByName": "string",
- "statusReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "systemModifiedDatetime": "2019-08-24T14:15:22Z",
- "udfVersionNumber": 0,
- "userReference": {
- "_type": "dataItemType",
- "displayName": "string",
- "guid": "6c556cd8-ac27-4167-844c-f00ddb170b3f",
- "sid": 1
}, - "verifiedFlag": true,
- "versionNumber": 0
}, - "errors": [
- { }
], - "warnings": [
- { }
], - "hasErrors": false,
- "hasWarnings": false
}
Use the In Use Tool on a Contact
Use the In Use Tool on a Contact.
OK
Bad Request
Forbidden
Not Found
Method Not Allowed
Internal Server Error
- 200
- 400
- 403
- 404
- 405
- 500
{- "result": [
- {
- "referencedIn": "string",
- "id": "string",
- "description": "string"
}
], - "errors": [ ],
- "warnings": [ ],
- "hasErrors": false,
- "hasWarnings": false
}
Execute the Resolve Tool on an existing Contact
Execute the Resolve Tool on an existing Contact.
Note: You must enable at least one of the Resolve Types.
query Parameters
Request Body schema: application/json
OK
Bad Request
Forbidden
Not Found
Method Not Allowed
Internal Server Error
- Payload
{- "verifyFlag": true,
- "lookupSQLFlag": true,
- "dateReferenceFlag": true,
- "udfCopyFlag": true
}
- 200
- 400
- 403
- 404
- 405
- 500
{- "result": null,
- "errors": [ ],
- "warnings": [ ],
- "hasErrors": false,
- "hasWarnings": false
}
Verify an existing Contact
Verify an existing Contact
query Parameters
Request Body schema: application/json
OK
Bad Request
Forbidden
Not Found
Method Not Allowed
Internal Server Error
- Payload
{- "forceResolve": true
}
- 200
- 400
- 403
- 404
- 405
- 500
{- "result": null,
- "errors": [ ],
- "warnings": [ ],
- "hasErrors": false,
- "hasWarnings": false
}
Verify all Contacts
Verify all existing Contacts.
query Parameters
Request Body schema: application/json
OK
Bad Request
Forbidden
Not Found
Method Not Allowed
Internal Server Error
- Payload
{- "forceResolve": true
}
- 200
- 400
- 403
- 404
- 405
- 500
{- "result": null,
- "errors": [ ],
- "warnings": [ ],
- "hasErrors": false,
- "hasWarnings": false
}