Bulk Attachments

This bulk download service provides access to complete copies of recently published attachments packaged in a convenient archive. For more information about what is included in our attachment collection, see Attachment Server Description and Coverage. If you are interested in accessing this service, please contact your sales representative.

/check

Check the availability of attachment packages.

MethodGET
Path/update/attachments/check
Parameter
ValuesDescription

@max_attachment_file_idinteger: e.g., 20190826193341The attachment_file_id from which to check if subsequent packages are available

@limitinteger: e.g., 10Number of attachment file structures to return. Default: 10

Example

Request

wget -O- -q \ 
--header 'x-user:x' \
--header 'x-password:y' \
'https://cdws21.ificlaims.com/update/attachments/check?max_attachment_file_id=20190826193341&limit=1'

Response

{
   "attachment_files_count" : 9,
   "attachment_files" : [
      {
         "country" : "CN",
         "checksum" : "b444a0bb07d8154de36f46cc146b607d",
         "created_stamp" : "2019-08-29 01:36:27.800122",
         "attachment_file_id" : 20190829010502,
         "url" : "https://bulk-attachments.s3.amazonaws.com/20190829/20190829...",
         "size" : 2036161157
      }
   ],
   "status" : "success",
   "time" : "0.139"
}

Details

JSON MemberDescription
statusRequest status (success | failed)
timeTime, in seconds, to complete the request
attachment_files_countTotal number of available packages
attachment_filesAn array of attachment file structures. Members described below.
.countryPublishing country of attachments
.checksumMD5 checksum of attachment file
.created_stampTimestamp of file creation
.attachment_file_idIdentifier of attachment file
.url

Signed URL of attachment file

.sizeSize, in bytes, of attachment file

/next

Fetch the next available attachments file.

MethodGET
Path/update/attachments/next
Parameter
ValuesDescription

@max_attachment_file_idInteger: e.g., 20190826193341The maximum attachment_file_id from which to check if subsequent files are available

Example

Request

wget -O- -q  \
  --header 'x-user:x' \
  --header 'x-password:y' \
'https://cdws21.ificlaims.com/update/attachments/next?max_attachment_file_id=20190826193341'

Response

{
   "status" : "success",
   "time" : "0.130",
   "attachment_file" : {
      "country" : "CN",
      "checksum" : "b444a0bb07d8154de36f46cc146b607d",
      "created_stamp" : "2019-08-29 01:36:27.800122",
      "attachment_file_id" : 20190829010502,
      "url" : "https://bulk-attachments.s3.amazonaws.com/20190829/20190829010502.tar....",
      "size" : 2036161157
   }
}

Please see above for a detailed description of the response members.

/info

Fetch information pertaining to a particular attachment-file-id.

MethodGET
Path/update/attachments/info
Parameter
ValuesDescription

@attachment_file_idInteger: e.g., 20190826193341The attachment_file_id  of interest

Example

Request

wget -O- -q  \
  --header 'x-user:x' \ 
  --header 'x-password:y' \
'https://cdws21.ificlaims.com/update/attachments/info?attachment_file_id=20190826193341'

Response

{
   "status" : "success",
   "time" : "0.094",
   "attachment_file" : {
      "country" : "CN",
      "checksum" : "b444a0bb07d8154de36f46cc146b607d",
      "created_stamp" : "2019-08-29 01:36:27.800122",
      "attachment_file_id" : 20190829010502,
      "url" : "https://bulk-attachments.s3.amazonaws.com/20190829/201908290...",
      "size" : 2036161157
   }
}

Please see above for a detailed description of the response members.

Viewing the package content

There is an IDX file inside the package specifically to map ucids to paths. To find the path for specific attachments:

1. Download the compressed file:

wget -O 20191011144848.tar.gz  'https://bulk-attachments-test.s3....'

2. Extract the files:

tar zxvf 20191011144848.tar.gz

3. Display the content of the .idx file:

cat 20191011130831.idx

4. This will provide the path:

AT-520942-B1 20190915 462161 AT/20190915/B1/000000/52/09/42/AT520942B1.pdf