Operations
GET /legaldeliverableoptions
Summary | Get list of available legal deliverable options | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
URL | /api/v1/legaldeliverableoptions | ||||||||||
Detailed Description |
Use this method to determine what options are available to you for each possible legal deliverable type.
Each deliverable type will return with a list of availabilities that can be used to place a legal transcription order
with the appropriate |
||||||||||
Request Headers |
|
||||||||||
Request Parameters |
Calling the /legaldeliverableoptions endpoint requires that you specify the length of the primary file in seconds you are intending to order with as a query parameter.
|
||||||||||
Response |
On success, 200 OK. On error, 400 Bad Request. If the user is not a legal transcription customer, 403 Forbidden. |
||||||||||
Response Body |
On success, a <deliverable_options/> entity with a list of available legal deliverable options. On error, will contain an <error/> entity with more details. The list of deliverable options will contain the following for each deliverable option:
|
||||||||||
Annotated sample response |
{ /* A list of available legal deliverable options. */ "deliverable_options": [ { /* The type of legal deliverable that can be ordered. */ "deliverable_type": "legal_ready_to_certify", /* Whether this legal deliverable type is currently available for ordering. */ "available": true, /* A list of available options for delivery based on business days from the current time of the request. */ "delivery_options": [ { /* An option for the number of business days the following completed deliverable will be returned back to you by. */ "business_days": 0, /* An option for the expected date and time (in UTC) the following completed deliverable will be returned back to you by. This should match with the number of business days specified in the same delivery option. */ "delivery_date": "2024-07-19T03:59:59Z", /* An expiration date and time (in UTC) for the option where an order can be placed and fulfilled within the given business day time frame. */ "valid_until": "2024-07-18T21:59:59Z" }, { "business_days": 1, "delivery_date": "2024-07-20T03:59:59Z", "valid_until": "2024-07-19T03:59:59Z" }, { "business_days": 2, "delivery_date": "2024-07-23T03:59:59Z", "valid_until": "2024-07-19T03:59:59Z" }, { "business_days": 3, "delivery_date": "2024-07-24T03:59:59Z", "valid_until": "2024-07-19T03:59:59Z" }, { "business_days": 4, "delivery_date": "2024-07-25T03:59:59Z", "valid_until": "2024-07-19T03:59:59Z" }, { "business_days": 5, "delivery_date": "2024-07-26T03:59:59Z", "valid_until": "2024-07-19T03:59:59Z" } ] }, { "deliverable_type": "legal_human_rough_draft", "available": false, /* A list of details to explain why some delivery options are available or unavailable at the time of the request. */ "availability_details": [ { /* A special code for why the deliverable type in question is available or unavailable. */ "availability_code": 3, /* A reason for why the deliverable type in question is available or unavailable. */ "message": "This deliverable type is not available for this user." } ] }, { "deliverable_type": "legal_ai_rough_draft", "available": true, "availability_details": [ { "availability_code": 1, "message": "Legal AI Rough Drafts are always available and will be delivered as soon as possible." } ] } ] } <legal_deliverable_options> <!-- A list of available legal deliverable options. --> <deliverable_options> <!-- The type of legal deliverable that can be ordered. --> <deliverable_type>legal_ready_to_certify</deliverable_type> <!-- Whether this legal deliverable type is currently available for ordering. --> <available>true</available> <!-- A list of available options for delivery based on business days from the current time of the request. --> <delivery_options> <!-- An option for the number of business days the following completed deliverable will be returned back to you by. --> <business_days>0</business_days> <!-- An option for the date and time (in UTC) the following completed deliverable will be returned back to you by. This should match with the number of business days specified in the same delivery option. --> <delivery_date>2024-07-19T03:59:59Z</delivery_date> <!-- An expiration date and time (in UTC) for the option where an order can be placed and fulfilled within the given business day time frame. --> <valid_until>2024-07-18T21:59:59Z</valid_until> </delivery_options> <delivery_options> <business_days>1</business_days> <delivery_date>2024-07-20T03:59:59Z</delivery_date> <valid_until>2024-07-19T03:59:59Z</valid_until> </delivery_options> <delivery_options> <business_days>2</business_days> <delivery_date>2024-07-23T03:59:59Z</delivery_date> <valid_until>2024-07-19T03:59:59Z</valid_until> </delivery_options> <delivery_options> <business_days>3</business_days> <delivery_date>2024-07-24T03:59:59Z</delivery_date> <valid_until>2024-07-19T03:59:59Z</valid_until> </delivery_options> <delivery_options> <business_days>4</business_days> <delivery_date>2024-07-25T03:59:59Z</delivery_date> <valid_until>2024-07-19T03:59:59Z</valid_until> </delivery_options> <delivery_options> <business_days>5</business_days> <delivery_date>2024-07-26T03:59:59Z</delivery_date> <valid_until>2024-07-19T03:59:59Z</valid_until> </delivery_options> </deliverable_options> <deliverable_options> <deliverable_type>legal_human_rough_draft</deliverable_type> <available>false</available> <!-- A list of details to explain why some delivery options are available or unavailable at the time of the request. --> <availability_details> <!-- A special code for why the deliverable type in question is available or unavailable. --> <availability_code>3</availability_code> <!-- A reason for why the deliverable type in question is available or unavailable. --> <message>This deliverable type is not available for this user.</message> </availability_details> </deliverable_options> <deliverable_options> <deliverable_type>legal_ai_rough_draft</deliverable_type> <available>true</available> <availability_details> <availability_code>1</availability_code> <message>Legal AI Rough Drafts are always available and will be delivered as soon as possible.</message> </availability_details> </deliverable_options> </legal_deliverable_options> |