Class Reports

Reports help to estimate costs, calculate translation costs, and identify the top members.

Use API to generate Cost Estimate, Translation Cost, and Top Members reports. You can then export reports in .xlsx or .csv file formats. Report generation is an asynchronous operation and shall be completed with a sequence of API methods.

Hierarchy (view full)

CrowdinApi
- Reports

Index

Constructors

constructor

Methods

addOrganizationReportSettingsTemplate addReportSettingsTemplate addUserReportSettingsTemplate checkGroupReportStatus checkOrganizationReportArchiveStatus checkOrganizationReportStatus checkReportStatus checkUserReportArchiveStatus deleteOrganizationReportArchive deleteOrganizationReportSettingsTemplate deleteReportSettingsTemplate deleteUserReportArchive deleteUserReportSettingsTemplate downloadGroupReport downloadOrganizationReport downloadOrganizationReportArchive downloadReport downloadUserReportArchive editOrganizationReportSettingsTemplate editReportSettingsTemplate editUserReportSettingsTemplate exportOrganizationReportArchive exportUserReportArchive generateGroupReport generateOrganizationReport generateReport getOrganizationReportArchive getOrganizationReportSettingsTemplate getReportSettingsTemplate getUserReportArchive getUserReportSettingsTemplate graphql listOrganizationReportArchives listOrganizationReportSettingsTemplates listReportSettingsTemplates listUserReportArchives listUserReportSettingsTemplates withFetchAll

Constructors

constructor

new Reports(credentials, config?): Reports
Parameters
- credentials: Credentials
  credentials
- Optionalconfig: ClientConfig
  optional configuration of the client
Returns Reports
Inherited from CrowdinApi.constructor
- Defined in core/index.ts:232

Methods

checkUserReportArchiveStatus

checkUserReportArchiveStatus(userId, archiveId, exportId): Promise<ResponseObject<Status<ReportArchiveStatusAttribute>>>
Parameters
- userId: number
  user identifier
- archiveId: number
  archive identifier
- exportId: string
  export identifier
Returns Promise<ResponseObject<Status<ReportArchiveStatusAttribute>>>
See
https://developer.crowdin.com/api/v2/#operation/api.users.reports.archives.exports.get
- Defined in reports/index.ts:140

deleteOrganizationReportArchive

deleteOrganizationReportArchive(archiveId): Promise<void>
Parameters
- archiveId: number
  archive identifier
Returns Promise<void>
See
https://developer.crowdin.com/enterprise/api/v2/#operation/api.reports.archives.delete
- Defined in reports/index.ts:45

deleteOrganizationReportSettingsTemplate

deleteOrganizationReportSettingsTemplate(reportSettingsTemplateId): Promise<void>
Parameters
- reportSettingsTemplateId: number
  report settings template identifier
Returns Promise<void>
See
https://support.crowdin.com/developer/enterprise/api/v2/#tag/Reports/operation/api.reports.settings-templates.delete
- Defined in reports/index.ts:252

deleteReportSettingsTemplate

deleteReportSettingsTemplate(projectId, reportSettingsTemplateId): Promise<void>
Parameters
- projectId: number
  project identifier
- reportSettingsTemplateId: number
  report settings template identifier
Returns Promise<void>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.settings-templates.delete
- Defined in reports/index.ts:383

deleteUserReportArchive

deleteUserReportArchive(userId, archiveId): Promise<void>
Parameters
- userId: number
  user identifier
- archiveId: number
  archive identifier
Returns Promise<void>
See
https://developer.crowdin.com/api/v2/#operation/api.users.reports.archives.delete
- Defined in reports/index.ts:115

deleteUserReportSettingsTemplate

deleteUserReportSettingsTemplate(userId, reportSettingsTemplateId): Promise<void>
Parameters
- userId: number
  user identifier
- reportSettingsTemplateId: number
  report settings template identifier
Returns Promise<void>
See
https://support.crowdin.com/developer/api/v2/#tag/Reports/operation/api.users.reports.settings-templates.delete
- Defined in reports/index.ts:447

downloadGroupReport

downloadGroupReport(groupId, reportId): Promise<ResponseObject<DownloadLink>>
Parameters
- groupId: number
  group identifier
- reportId: string
  report identifier
Returns Promise<ResponseObject<DownloadLink>>
See
https://support.crowdin.com/enterprise/api/#operation/api.groups.reports.download.download
- Defined in reports/index.ts:195

downloadOrganizationReport

downloadOrganizationReport(reportId): Promise<ResponseObject<DownloadLink>>
Parameters
- reportId: string
  report identifier
Returns Promise<ResponseObject<DownloadLink>>
See
https://support.crowdin.com/enterprise/api/#operation/api.reports.download.download
- Defined in reports/index.ts:283

downloadOrganizationReportArchive

downloadOrganizationReportArchive(archiveId, exportId): Promise<ResponseObject<DownloadLink>>
Parameters
- archiveId: number
  archive identifier
- exportId: string
  export identifier
Returns Promise<ResponseObject<DownloadLink>>
See
https://developer.crowdin.com/enterprise/api/v2/#operation/api.reports.archives.exports.download.get
- Defined in reports/index.ts:80

downloadReport

downloadReport(projectId, reportId): Promise<ResponseObject<DownloadLink>>
Parameters
- projectId: number
  project identifier
- reportId: string
  report identifier
Returns Promise<ResponseObject<DownloadLink>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.reports.download.download
- Defined in reports/index.ts:319

downloadUserReportArchive

downloadUserReportArchive(userId, archiveId, exportId): Promise<ResponseObject<DownloadLink>>
Parameters
- userId: number
  user identifier
- archiveId: number
  archive identifier
- exportId: string
  export identifier
Returns Promise<ResponseObject<DownloadLink>>
See
https://developer.crowdin.com/api/v2/#operation/api.users.reports.archives.exports.download.get
- Defined in reports/index.ts:155

editOrganizationReportSettingsTemplate

editOrganizationReportSettingsTemplate(reportSettingsTemplateId, request): Promise<ResponseObject<OrganizationReportSettings>>
Parameters
- reportSettingsTemplateId: number
  report settings template identifier
- request: PatchRequest[]
  request body
Returns Promise<ResponseObject<OrganizationReportSettings>>
See
https://support.crowdin.com/developer/enterprise/api/v2/#tag/Reports/operation/api.reports.settings-templates.patch
- Defined in reports/index.ts:240

editReportSettingsTemplate

editReportSettingsTemplate(projectId, reportSettingsTemplateId, request): Promise<ResponseObject<ReportSettings>>
Parameters
- projectId: number
  project identifier
- reportSettingsTemplateId: number
  report settings template identifier
- request: PatchRequest[]
  request body
Returns Promise<ResponseObject<ReportSettings>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.reports.settings-templates.patch
- Defined in reports/index.ts:369

editUserReportSettingsTemplate

editUserReportSettingsTemplate(userId, reportSettingsTemplateId, request): Promise<ResponseObject<UserReportSettings>>
Parameters
- userId: number
  user identifier
- reportSettingsTemplateId: number
  report settings template identifier
- request: PatchRequest[]
  request body
Returns Promise<ResponseObject<UserReportSettings>>
See
https://support.crowdin.com/developer/api/v2/#tag/Reports/operation/api.users.reports.settings-templates.patch
- Defined in reports/index.ts:433

exportOrganizationReportArchive

exportOrganizationReportArchive(archiveId, request?): Promise<ResponseObject<Status<ReportArchiveStatusAttribute>>>
Parameters
- archiveId: number
  archive identifier
- request: {
  format?: ReportsModel.Format;
  } = {}
  - Optionalformat?: ReportsModel.Format
Returns Promise<ResponseObject<Status<ReportArchiveStatusAttribute>>>
See
https://developer.crowdin.com/enterprise/api/v2/#operation/api.reports.archives.exports.post
- Defined in reports/index.ts:54

exportUserReportArchive

exportUserReportArchive(userId, archiveId, request?): Promise<ResponseObject<Status<ReportArchiveStatusAttribute>>>
Parameters
- userId: number
  user identifier
- archiveId: number
  archive identifier
- request: {
  format?: ReportsModel.Format;
  } = {}
  - Optionalformat?: ReportsModel.Format
Returns Promise<ResponseObject<Status<ReportArchiveStatusAttribute>>>
See
https://developer.crowdin.com/api/v2/#operation/api.reports.archives.exports.post
- Defined in reports/index.ts:125

generateGroupReport

generateGroupReport(groupId, request): Promise<ResponseObject<Status<ReportStatusAttributes<GroupReportSchema>>>>
Parameters
- groupId: number
  group identifier
- request: GenerateGroupReportRequest
  request body
Returns Promise<ResponseObject<Status<ReportStatusAttributes<GroupReportSchema>>>>
See
https://support.crowdin.com/enterprise/api/#operation/api.groups.reports.post
- Defined in reports/index.ts:169

generateOrganizationReport

generateOrganizationReport(request): Promise<ResponseObject<Status<ReportStatusAttributes<OrganizationReportSchema>>>>
Parameters
- request: GenerateOrganizationReportRequest
  request body
Returns Promise<ResponseObject<Status<ReportStatusAttributes<OrganizationReportSchema>>>>
See
https://support.crowdin.com/enterprise/api/#operation/api.reports.post
- Defined in reports/index.ts:261

generateReport

generateReport(projectId, request): Promise<ResponseObject<Status<ReportStatusAttributes<ReportSchema>>>>
Parameters
- projectId: number
  project identifier
- request: GenerateReportRequest
  request body
Returns Promise<ResponseObject<Status<ReportStatusAttributes<ReportSchema>>>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.reports.post
- Defined in reports/index.ts:293

getOrganizationReportArchive

getOrganizationReportArchive(archiveId): Promise<ResponseObject<ReportArchive>>
Parameters
- archiveId: number
  archive identifier
Returns Promise<ResponseObject<ReportArchive>>
See
https://developer.crowdin.com/enterprise/api/v2/#operation/api.reports.archives.get
- Defined in reports/index.ts:36

getOrganizationReportSettingsTemplate

getOrganizationReportSettingsTemplate(reportSettingsTemplateId): Promise<ResponseObject<OrganizationReportSettings>>
Parameters
- reportSettingsTemplateId: number
  report settings template identifier
Returns Promise<ResponseObject<OrganizationReportSettings>>
See
https://support.crowdin.com/developer/enterprise/api/v2/#tag/Reports/operation/api.reports.settings-templates.get
- Defined in reports/index.ts:228

getReportSettingsTemplate

getReportSettingsTemplate(projectId, reportSettingsTemplateId): Promise<ResponseObject<ReportSettings>>
Parameters
- projectId: number
  project identifier
- reportSettingsTemplateId: number
  report settings template identifier
Returns Promise<ResponseObject<ReportSettings>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.reports.settings-templates.get
- Defined in reports/index.ts:355

getUserReportArchive

getUserReportArchive(userId, archiveId): Promise<ResponseObject<ReportArchive>>
Parameters
- userId: number
  user identifier
- archiveId: number
  archive identifier
Returns Promise<ResponseObject<ReportArchive>>
See
https://developer.crowdin.com/api/v2/#operation/api.users.reports.archives.get
- Defined in reports/index.ts:105

getUserReportSettingsTemplate

getUserReportSettingsTemplate(userId, reportSettingsTemplateId): Promise<ResponseObject<UserReportSettings>>
Parameters
- userId: number
  user identifier
- reportSettingsTemplateId: number
  report settings template identifier
Returns Promise<ResponseObject<UserReportSettings>>
See
https://support.crowdin.com/developer/api/v2/#tag/Reports/operation/api.users.reports.settings-templates.get
- Defined in reports/index.ts:419

graphql

graphql<T>(req, config?): Promise<ResponseObject<T>>
Type Parameters
- T
Parameters
- req: {
      operationName?: string;
      query: string;
      variables?: any;
  }
  - OptionaloperationName?: string
  - query: string
  - Optionalvariables?: any
- config: {
  url?: string;
  } = {}
  - Optionalurl?: string
Returns Promise<ResponseObject<T>>
Inherited from CrowdinApi.graphql
- Defined in core/index.ts:266

listOrganizationReportArchives

listOrganizationReportArchives(options?): Promise<ResponseList<ReportArchive>>
Parameters
- Optionaloptions: ListReportArchiveParams
  optional parameters for the request
Returns Promise<ResponseList<ReportArchive>>
See
https://developer.crowdin.com/enterprise/api/v2/#operation/api.reports.archives.getMany
- Defined in reports/index.ts:23

listOrganizationReportSettingsTemplates

listOrganizationReportSettingsTemplates(options?): Promise<ResponseList<OrganizationReportSettings>>
Parameters
- Optionaloptions: ListOrganizationReportSettingsParams
  optional parameters for the request
Returns Promise<ResponseList<OrganizationReportSettings>>
See
https://support.crowdin.com/developer/enterprise/api/v2/#tag/Reports/operation/api.reports.settings-templates.getMany
- Defined in reports/index.ts:204

listReportSettingsTemplates

listReportSettingsTemplates(projectId, options?): Promise<ResponseList<ReportSettings>>
Parameters
- projectId: number
  project identifier
- Optionaloptions: Partial<Pagination>
  optional parameters for the request
Returns Promise<ResponseList<ReportSettings>>
See
https://developer.crowdin.com/api/v2/#operation/api.projects.reports.settings-templates.getMany
- Defined in reports/index.ts:329

listUserReportArchives

listUserReportArchives(userId, options?): Promise<ResponseList<ReportArchive>>
Parameters
- userId: number
  user identifier
- Optionaloptions: ListReportArchiveParams
  optional parameters for the request
Returns Promise<ResponseList<ReportArchive>>
See
https://developer.crowdin.com/api/v2/#operation/api.reports.archives.getMany
- Defined in reports/index.ts:90

listUserReportSettingsTemplates

listUserReportSettingsTemplates(userId, options?): Promise<ResponseList<UserReportSettings>>
Parameters
- userId: number
  user identifier
- Optionaloptions: Partial<Pagination>
  optional parameters for the request
Returns Promise<ResponseList<UserReportSettings>>
See
https://support.crowdin.com/developer/api/v2/#tag/Reports/operation/api.users.reports.settings-templates.getMany
- Defined in reports/index.ts:393

withFetchAll

withFetchAll(maxLimit?): this
Parameters
- OptionalmaxLimit: number
Returns this
Inherited from CrowdinApi.withFetchAll
- Defined in core/index.ts:328

Class Reports

Hierarchy (view full)

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns Reports

Methods

addOrganizationReportSettingsTemplate

Parameters

Returns Promise<ResponseObject<OrganizationReportSettings>>

See

addReportSettingsTemplate

Parameters

Returns Promise<ResponseObject<ReportSettings>>

See

addUserReportSettingsTemplate

Parameters

Returns Promise<ResponseObject<UserReportSettings>>

See

checkGroupReportStatus

Parameters

Returns Promise<ResponseObject<Status<ReportStatusAttributes<GroupReportSchema>>>>

See

checkOrganizationReportArchiveStatus

Parameters

Returns Promise<ResponseObject<Status<ReportArchiveStatusAttribute>>>

See

checkOrganizationReportStatus

Parameters

Returns Promise<ResponseObject<Status<ReportStatusAttributes<OrganizationReportSchema>>>>

See

checkReportStatus

Parameters

Returns Promise<ResponseObject<Status<ReportStatusAttributes<ReportSchema>>>>

See

checkUserReportArchiveStatus

Parameters

Returns Promise<ResponseObject<Status<ReportArchiveStatusAttribute>>>

See

deleteOrganizationReportArchive

Parameters

Returns Promise<void>

See

deleteOrganizationReportSettingsTemplate

Parameters

Returns Promise<void>

See

deleteReportSettingsTemplate

Parameters

Returns Promise<void>

See

deleteUserReportArchive

Parameters

Returns Promise<void>

See

deleteUserReportSettingsTemplate

Parameters

Returns Promise<void>

See

downloadGroupReport

Parameters

Returns Promise<ResponseObject<DownloadLink>>

See

downloadOrganizationReport

Parameters

Returns Promise<ResponseObject<DownloadLink>>

See

downloadOrganizationReportArchive

Parameters

Returns Promise<ResponseObject<DownloadLink>>

See

downloadReport

Parameters

Returns Promise<ResponseObject<DownloadLink>>

See

downloadUserReportArchive

Parameters

`Optional`format?: ReportsModel.Format

`Optional`format?: ReportsModel.Format

`Optional`operationName?: string

`Optional`variables?: any

`Optional`url?: string