DigiOffice Gateway Web Services

<back to all web services

GetDocumentByNumber

Get the details of a document by reference number

Requires Authentication
The following routes are available for this service:
POST/api/documents/number
GetDocumentByNumber Parameters:
NameParameterData TypeRequiredDescription
NumberbodystringNo
VersionbodystringNo
Document Parameters:
NameParameterData TypeRequiredDescription
IDformGuidNo
RootDocumentIDformGuidNo
RegistrationprofileIDformGuidNo
TitleformstringNo
FullTitleformstringNo
NumberformstringNo
VersionformstringNo
ExternalNumberformstringNo
ExternalVersionformstringNo
InternalNumberformstringNo
InternalInvoiceNumberformstringNo
PersonIDformintNo
RelationIDformintNo
RelationTitleformstringNo
ProjectIDformintNo
ProjectTitleformstringNo
ExtensionformstringNo
DateformDateTime?No
CommentsCountformintNo
HasCommentsformboolNo
HasPreviewformboolNo
ExtraFieldformstringNo
IsFavoriteformboolNo
DocumentcategoryTextformstringNo
FileSizeformlong?No
FileDateformDateTime?No
HashformstringNo
HashTypeformstringNo
FileUrlformstringNo
StandardDocumentUrlformstringNo
IsCorporateIdentityformboolNo
UserTitleformstringNo
IsFrozenformboolNo
InternalCompanyIDformintNo
DirectUrlformstringNo
AllowDigitalSigningOnlyOnPrimaryVersionsformboolNo
IsPrimaryVersionformboolNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /api/documents/number HTTP/1.1 
Host: doapigw.baasbv.nl 
Accept: application/json
Content-Type: application/json
Content-Length: length

{"__type":"IDB.API.DTO.Document.Operations.GetDocumentByNumber, IDB.API.DTO","Number":"String","Version":"String"}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"__type":"IDB.API.DTO.Document.Document, IDB.API.DTO","ID":"00000000-0000-0000-0000-000000000000","RootDocumentID":"00000000-0000-0000-0000-000000000000","RegistrationprofileID":"00000000-0000-0000-0000-000000000000","Title":"String","FullTitle":"String","Number":"String","Version":"String","ExternalNumber":"String","ExternalVersion":"String","InternalNumber":"String","InternalInvoiceNumber":"String","PersonID":0,"RelationID":0,"RelationTitle":"String","ProjectID":0,"ProjectTitle":"String","Extension":"String","Date":"0001-01-01T00:00:00.0000000","CommentsCount":0,"HasComments":false,"HasPreview":false,"ExtraField":"String","IsFavorite":false,"DocumentcategoryText":"String","FileSize":0,"FileDate":"0001-01-01T00:00:00.0000000","Hash":"String","HashType":"String","FileUrl":"String","StandardDocumentUrl":"String","IsCorporateIdentity":false,"UserTitle":"String","IsFrozen":false,"InternalCompanyID":0,"DirectUrl":"String","AllowDigitalSigningOnlyOnPrimaryVersions":false,"IsPrimaryVersion":false}