v4

latestSwagger 2.02026-07-1382857.5 KB

Returns the status for all documents in a batch document translation request

Returns the status for all documents in a batch document translation request.

If the number of documents in the response exceeds our paging limit, server-side paging is used. Paginated responses indicate a partial result and include a continuation token in the response. The absence of a continuation token means that no additional pages are available.

top, skip and maxpagesize query parameters can be used to specify a number of results to return and an offset for the collection.

top indicates the total number of records the user wants to be returned across all pages. skip indicates the number of records to skip from the list of document status held by the server based on the sorting method specified. By default, we sort by descending start time. maxpagesize is the maximum items returned in a page. If more items are requested via top (or top is not specified and there are more items to be returned), @nextLink will contain the link to the next page.

orderby query parameter can be used to sort the returned list (ex "orderby=createdDateTimeUtc asc" or "orderby=createdDateTimeUtc desc"). The default sorting is descending by createdDateTimeUtc. Some query parameters can be used to filter the returned list (ex: "status=Succeeded,Cancelled") will only return succeeded and cancelled documents. createdDateTimeUtcStart and createdDateTimeUtcEnd can be used combined or separately to specify a range of datetime to filter the returned list by. The supported filtering query parameters are (status, ids, createdDateTimeUtcStart, createdDateTimeUtcEnd).

When both top and skip are included, the server should first apply skip and then top on the collection. Note: If the server can't honor top and/or skip, the server must return an error to the client informing about it instead of just ignoring the query options. This reduces the risk of the client making assumptions about the data returned.

get/document/batches/{id}/documents

Path parameters

idstring uuid required

Format - uuid. The operation id

Query parameters

api-versionstring required

The API version to use for this operation.

topinteger

top indicates the total number of records the user wants to be returned across all pages.

Clients MAY use top and skip query parameters to specify a number of results to return and an offset into the collection. When both top and skip are given by a client, the server SHOULD first apply skip and then top on the collection.

Note: If the server can't honor top and/or skip, the server MUST return an error to the client informing about it instead of just ignoring the query options.

skipinteger

skip indicates the number of records to skip from the list of records held by the server based on the sorting method specified. By default, we sort by descending start time.

Clients MAY use top and skip query parameters to specify a number of results to return and an offset into the collection. When both top and skip are given by a client, the server SHOULD first apply skip and then top on the collection.

Note: If the server can't honor top and/or skip, the server MUST return an error to the client informing about it instead of just ignoring the query options.

maxpagesizeinteger

maxpagesize is the maximum items returned in a page. If more items are requested via top (or top is not specified and there are more items to be returned), @nextLink will contain the link to the next page.

Clients MAY request server-driven paging with a specific page size by specifying a maxpagesize preference. The server SHOULD honor this preference if the specified page size is smaller than the server's default page size.

idsstring[]

Ids to use in filtering

statusesstring[]

Statuses to use in filtering

createdDateTimeUtcStartstring date-time

the start datetime to get items after

createdDateTimeUtcEndstring date-time

the end datetime to get items before

orderbystring[]

the sorting query for the collection (ex: 'CreatedDateTimeUtc asc','CreatedDateTimeUtc desc')

Response

The request has succeeded.

nextLinkstring

Url for the next page. Null if no more pages available