The IdentityDocument API does not support XML format.

Add

Add a new IdentityDocument.

Request Format

Method

POST

URL

/identity_documents.<format>

Request Body

IdentityDocument Request

Response Format

HTTP Status

Response Body

Description

201 Added

NewObjectResponse with ObjectType of IdentityDocument

IdentityDocument added

400 Bad Request


IdentityDocument Request not provided in POST body

400 Invalid Fields

ErrorResponse with details in InvalidFields element

An error in one or more provided fields

401 Unauthorized


Authentication required

403 No Person Specified


A CO Person must be specified to attach the IdentityDocument to

403 Person Does Not Exist


The specified CO Person does not exist

500 Other Error


Unknown error


Delete

Remove an IdentityDocument.

Request Format

Method

DELETE

URL

/identity_documents/<id>.<format>

Request Body


Response Format

HTTP Status

Response Body

Description

200 Deleted


IdentityDocument deleted

400 Invalid Fields


id not provided

401 Unauthorized


Authentication required

404 IdentityDocument Unknown


id not found

500 Other Error


Unknown error


Edit

Edit an existing IdentityDocument.

Request Format

Method

PUT

URL

/identity_documents/<id>.<format>

Request Body

IdentityDocument Request

Response Format

HTTP Status

Response Body

Description

200 OK


IdentityDocument updated

400 Bad Request


IdentityDocument Request not provided in POST body

400 Invalid Fields

ErrorResponse with details in InvalidFields element

An error in one or more provided fields

401 Unauthorized


Authentication required

403 No Person Specified


A CO Person must be specified to attach the Address to

403 Person Does Not Exist


The specified CO Person does not exist

404 IdentityDocument Unknown


id not found

500 Other Error


Unknown error


View (all)

Retrieve all existing IdentityDocuments.

Request Format

Method

GET

URL

/identity_documents.<format>

Request Body


Response Format

HTTP Status

Response Body

Description

200 OK

IdentityDocument Response

IdentityDocuments returned

401 Unauthorized


Authentication required

500 Other Error


Unknown error


View (per entity)

Retrieve IdentityDocuments attached to a CO Person.

Request Format

Method

GET

URL

/identity_documents.<format>?[copersonid]=<id>

Request Body


Response Format

HTTP Status

Response Body

Description

200 OK

IdentityDocument Response

IdentityDocument returned

204 CO Person Has No IdentityDocument


The requested CO Person was found, but has no IdentityDocuments attached

401 Unauthorized


Authentication required

404 CO Person Unknown


id not found for CO Person

500 Other Error


Unknown error


View (one)

Retrieve an existing IdentityDocument.

Request Format

Method

GET

URL

/identity_documents/<id>.<format>

Request Body


Response Format

HTTP Status

Response Body

Description

200 OK

IdentityDocument Response

IdentityDocument returned

401 Unauthorized


Authentication required

404 IdentityDocument Unknown


id not found

500 Other Error


Unknown error


Notes

  • Response format requested is ignored where response is only via HTTP status, but must still be provided.

See Also

  • No labels