Privileged and Confidential This endpoint design has been confidentially shared with you. It is still under development and is subject to change without notice. Please do not share this document or API endpoint details with anyone who is not authorized to have access. For more information read about scopes.
Get the report’s generation status and other report related information using the report ID.
Resource
v1/vehicle-suppliers/suppliers/:org_id/reports/:report_id
HTTP Method
GET
Access Method
Client Credentials
Required scopes
Primary - solutions.suppliers.reports
Usage
The client should access the Get Organizations API that fetches the child organizations for the given organisation. This API returns the encrypted IDs for the linked organizations . The clients can then use the encrypted organization ID in the below request for getting report details.
For getting the master organisation’s encrypted uuid please reach out to support team. The report ID from the Generate Report API response should be used in the below request to fetch the status of the submitted report.
Example Request
curl -i -X GET "https://api.uber.com/v1/vehicle-suppliers/suppliers/<org_id>/reports/<report_id>"
-H "Authorization: Bearer <TOKEN>" \
-H "Content-Type: application/json" \
Request Path Parameters
Name |
Type |
Required |
Description |
org_id |
string |
Y |
This represents encrypted organisation Id. |
report_id |
string |
Y |
This is the reportId returned in response of the generate Report endpoint. |
Response Fields
Name |
Type |
Description |
report |
Object of Report |
Report entity |
Response Entities
Report
Name |
type |
Description |
id |
string |
This is the report id. |
fileName |
string |
This is the file name for requested report. |
orgId |
string |
This is organization id (obfuscated). |
reportType |
string |
Represents the type of the report ReportType. |
startTime |
string |
ISO UTC time format for example 2023-03-30T00:13:55.926Z. |
endTime |
string |
ISO UTC time format for example 2023-03-30T00:13:55.926Z. |
status |
string |
Represents the generation status of the report ReportStatus. |
failedReason |
string |
One of the values in FailedReason. |
createdAt |
string |
ISO UTC time format for example 2023-03-30T00:13:55.926Z. |
updatedAt |
string |
ISO UTC time format for example 2023-03-30T00:13:55.926Z. |
completedAt |
string |
ISO UTC time format for example 2023-03-30T00:13:55.926Z, represents the time when the report generation was completed. |
ReportType
Name |
Description |
REPORT_TYPE_ORGANIZATION |
List of organizations. |
REPORT_TYPE_PAYMENTS_ORDER |
Report having payment information for orders. |
REPORT_TYPE_PAYMENTS_DRIVER |
Report having payment information for driver. |
REPORT_TYPE_PAYMENTS_ORGANIZATION |
Report having payment information for organization. |
REPORT_TYPE_DRIVER_QUALITY |
Report having driver quality related information. |
REPORT_TYPE_DRIVER_ACTIVITY |
Report having driver activity related information. |
REPORT_TYPE_TRIP_ACTIVITY |
Report having trips related information. |
REPORT_TYPE_DRIVER_STATUS |
Report having driver realtime status and onboarding status related information. |
REPORT_TYPE_DRIVER |
Report having driver information. |
REPORT_TYPE_TRIP |
Report having trip information. |
REPORT_TYPE_VEHICLE_PERFORMANCE |
Report having vehicle performance related information. |
REPORT_TYPE_DRIVER_PERFORMANCE |
Report having driver performance related information. |
REPORT_TYPE_BACKFILL_REALTIME_DRIVER_STATUS_CHANGE_WEBHOOK_EVENTS |
Report containing failed delivery events for REALTIME_DRIVER_STATUS_CHANGE webhook |
ReportStatus
Name |
Description |
REPORT_STATUS_COMPLETED |
Report generation is completed. |
REPORT_STATUS_FAILED |
Report generation failed due to some issue. |
REPORT_STATUS_IN_PROGRESS |
Report generation is in progress. |
FailedReason
Name |
Description |
REPORT_GENERATION_FAILED_REASON_INTERNAL_SERVER_ERROR |
Failed due to some internal error. |
REPORT_GENERATION_FAILED_REASON_NONE |
No failure occured. |
Example Response
{
"report" : {
"id" : "dsuirhwiuhrfbryrurptpt",
"fileName" : "abcs.csv",
"orgId": "qoiewoifpwionfwoinwovmow4ivmp",
"reportType": "REPORT_TYPE_DRIVER_QUALITY",
"startTime" : "2023-03-30T00:13:55.926Z",
"endTime" :"2023-03-30T00:13:55.926Z",
"status" : "REPORT_STATUS_IN_PROGRESS",
"failedReason" : "REPORT_GENERATION_FAILED_REASON_NONE",
"createdAt" : "2023-06-30T00:13:55.926Z",
"updatedAt" : "2023-06-30T00:13:55.926Z",
"completedAt" : "2023-06-30T00:13:58.926Z"
}
}
Rate Limit
- Rate limit for this endpoint is 600 requests per 10 minutes per Developer Application.
Endpoint Specific Errors
Http Status Code |
Code |
Message |
400 |
bad_request |
The request parameters are invalid. |
500 |
internal_server_error |
Internal server error. |
403 |
unauthenticated |
User does not have permission. |
429 |
rate_limited |
Number of requests exceeds allowed limit. |
503 |
service_unavailable |
Service unavailable. |
401 |
unauthorized |
Invalid OAuth 2.0 credentials. |