Fetch one or all project tasks

How to get one or all the project tasks that were created during project creation. Each task represents one language pair.

  • Fetch all your project tasks 

Sandbox endpoint

https://api.platform.sandbox.easytranslate.com/api/v1/teams/:team_identifier/projects/:project_id/tasks

In order to fetch all your project tasks, you need to send a GET request. 

In your request's header, you need to add your access token, to do so, simply add "Authorization" as a key and "Bearer {{ACCESS_TOKEN}}" (instead of {{ACCESS_TOKEN}}, you should provide your access token)

You then need to pass two variables (team_identifier, project_id) in the path of your endpoint

    • Team_identifier: {{TEAM_IDENTIFIER}}
      Instead of {{TEAM_IDENTIFIER}} in the request example below, you need to provide the team_identifier of your team. It can be retrieved from the api/v1/user endpoint. The team_identifier is used to identify the projects of the authenticated account. 
    • Project_id: {{PROJECT_ID}}
      Instead of {{PROJECT_ID}} in the request example below, you simply have to specify the ID of the project you want to get. '

 

Sandbox request example

curl --location -g --request GET 'https://api.platform.sandbox.easytranslate.com/api/v1/teams/{{TEAM_NAME}}/projects/{{PROJECT_ID}}/tasks' \ --header 'Authorization: Bearer {{ACCESS_TOKEN}}'

 

Sandbox response example 

Once you send your request and get a response from the server, this is the information you will get out of it 

{
"data": [
{
"type": "task",
"id": "d4739c6c-fc0f-413f-b69d-caa288b30487",
"attributes": {
"target_content": null,
"target_language": "da",
"type": "translation",
"file_name": "data.json",
"word_count": 472,
"deadline": "2020-11-20",
"status": "COMPLETED",
"price": {
"amount": 7263,
"amount_euro": 6136,
"total": 7263,
"total_euro": 6136,
"currency": "USD"
},
"payment": {
"date": "2020-08-27",
"method": "digital",
"amount": 7263,
"currency": "USD",
"vat_percent": 0.25,
"gross_amount": 9079,
"invoice_url": "https://pay.stripe.com/invoice/acct_19n4RfHbEySjdvVG/invst_HuVfvi1eU4LZeX1rQCLXwXJ5mBp2DXQ/pdf"
},
"supplier_id": "70330f42-9c2c-4aaa-882d-fe46a17f960a",
"project_id": "ef1e29b6-6dcf-424b-858f-aa7f75a3cf65",
"progress": "0",
"is_rated": false,
"created_at": "2020-08-27T08:39:28.000000Z",
"updated_at": "2020-08-27T08:41:31.000000Z"
},
"relationships": {
"project": {
"id": "ef1e29b6-6dcf-424b-858f-aa7f75a3cf65",
"type": "project"
},
"supplier": {
"id": "70330f42-9c2c-4aaa-882d-fe46a17f960a",
"type": "supplier"
}
}
},
{
"type": "task",
"id": "df0f12b5-1db6-4822-a76b-882c0109283a",
"attributes": {
"target_content": null,
"target_language": "de",
"type": "translation",
"file_name": "data.json",
"word_count": 472,
"deadline": null,
"status": "ASSIGNED",
"price": {
"amount": 7263,
"amount_euro": 6136,
"total": 7263,
"total_euro": 6136,
"currency": "USD"
},
"payment": {
"date": "2020-08-27",
"method": "digital",
"amount": 7263,
"currency": "USD",
"vat_percent": 0.25,
"gross_amount": 9079,
"invoice_url": "https://pay.stripe.com/invoice/acct_19n4RfHbEySjdvVG/invst_HuVfvi1eU4LZeX1rQCLXwXJ5mBp2DXQ/pdf"
},
"supplier_id": "d2868128-ee54-4514-9c53-26a312649622",
"project_id": "ef1e29b6-6dcf-424b-858f-aa7f75a3cf65",
"progress": "0",
"is_rated": false,
"created_at": "2020-08-27T08:39:28.000000Z",
"updated_at": "2020-08-27T08:39:57.000000Z"
},
"relationships": {
"project": {
"id": "ef1e29b6-6dcf-424b-858f-aa7f75a3cf65",
"type": "project"
},
"supplier": {
"id": "d2868128-ee54-4514-9c53-26a312649622",
"type": "supplier"
}
}
}
],
"included": [
{
"type": "project",
"id": "ef1e29b6-6dcf-424b-858f-aa7f75a3cf65",
"attributes": {
"name": "Application Form #1",
"customer_id": "56e9b95b-7892-4eda-b28e-0b8a7e52b4f3",
"source_language": "en",
"source_content": "https://api.platform.sandbox.easytranslate.com/api/v1/teams/deadpool/projects/ef1e29b6-6dcf-424b-858f-aa7f75a3cf65/download",
"file_name": "data.json",
"target_languages": [
"da",
"de"
],
"agent": "EasyTranslate Dashboard",
"price": {
"amount": 14526,
"amount_euro": 12272,
"total": 14526,
"total_euro": 12272,
"currency": "USD"
},
"payment": {
"date": "2020-08-27",
"method": "digital",
"amount": 14526,
"currency": "USD",
"vat_percent": 0.25,
"gross_amount": 18158,
"invoice_url": "https://pay.stripe.com/invoice/acct_19n4RfHbEySjdvVG/invst_HuVfvi1eU4LZeX1rQCLXwXJ5mBp2DXQ/pdf"
},
"status": "ASSIGNED",
"folder_id": "27cf582a-9b22-41bf-a0ce-c9efefb66622",
"folder_name": "X-FORCE",
"callback_url": null,
"progress": {
"percent": 0.5,
"completed_tasks": 1
},
"created_at": "2020-08-27T08:39:27.000000Z",
"updated_at": "2020-08-27T08:39:58.000000Z"
},
"relationships": []
},
{
"type": "supplier",
"id": "70330f42-9c2c-4aaa-882d-fe46a17f960a",
"attributes": {
"first_name": "Marianne",
"last_name": "A.",
"avatar": null,
"created_at": "2020-03-26T12:00:25.000000Z",
"updated_at": "2020-07-09T10:38:00.000000Z"
}
},
{
"type": "supplier",
"id": "d2868128-ee54-4514-9c53-26a312649622",
"attributes": {
"first_name": "Bastian",
"last_name": "E.",
"avatar": "https://api.platform.sandbox.easytranslate.com/api/v1/users/cc15adaf-d391-4560-b16a-5ae7aa566a0d/avatar",
"created_at": "2020-03-13T12:42:12.000000Z",
"updated_at": "2020-08-17T10:48:20.000000Z"
}
}
],
"meta": {
"copyright": "Copyright 2020 EasyTranslate A/S",
"environment": "sandbox"
}
}
  • Fetch one project task 

Sandbox endpoint

https://api.platform.sandbox.easytranslate.com/api/v1/teams/:team_identifier/projects/:project_id/tasks/:task_id

In order to fetch one project task, you need to send a GET request. 

In your request's header, you need to add your access token, to do so, simply add "Authorization" as a key and "Bearer {{ACCESS_TOKEN}}" (instead of {{ACCESS_TOKEN}}, you should provide your access token)

In your request's header, you also need to specify the content type. To do so, add "Content-Type" as a key and "application/x-www-form-urlencoded" as its value. 

You then need to pass three variables (team_identifier, project_id, task_id) in the path of your endpoint

    • Team_identifier: {{TEAM_IDENTIFIER}}
      Instead of {{TEAM_IDENTIFIER}} in the request example below, you need to provide the team_identifier of your team. It can be retrieved from the api/v1/user endpoint. The team_identifier is used to identify the projects of the authenticated account. 
    • Project_id: {{PROJECT_ID}}
      Instead of {{PROJECT_ID}} in the request example below, you simply have to specify the ID of the project you want to get. '
    • Task_id: {{TASK_ID}}
      Instead of {{TASK_ID}} in the request example below, you simply have to specify the ID of the project task you want to get. '

 

Sandbox request example 

curl --location -g --request GET 'https://api.platform.sandbox.easytranslate.com/api/v1/teams/{{TEAM_NAME}}/projects/{{PROJECT_ID}}/tasks/{{TASK_ID}}' \ --header 'Authorization: Bearer {{ACCESS_TOKEN}}' \ --header 'Content-Type: application/x-www-form-urlencoded'

 

Sandbox response example 

Once you send your request and get a response from the server, this is the information you will get out of it 

{
"data": {
"type": "task",
"id": "d4739c6c-fc0f-413f-b69d-caa288b30487",
"attributes": {
"target_content": null,
"target_language": "da",
"type": "translation",
"file_name": "data.json",
"word_count": 472,
"deadline": "2020-11-20",
"status": "COMPLETED",
"price": {
"amount": 7263,
"amount_euro": 6136,
"total": 7263,
"total_euro": 6136,
"currency": "USD"
},
"payment": {
"date": "2020-08-27",
"method": "digital",
"amount": 7263,
"currency": "USD",
"vat_percent": 0.25,
"gross_amount": 9079,
"invoice_url": "https://pay.stripe.com/invoice/acct_19n4RfHbEySjdvVG/invst_HuVfvi1eU4LZeX1rQCLXwXJ5mBp2DXQ/pdf"
},
"supplier_id": "70330f42-9c2c-4aaa-882d-fe46a17f960a",
"project_id": "ef1e29b6-6dcf-424b-858f-aa7f75a3cf65",
"progress": "0",
"is_rated": false,
"created_at": "2020-08-27T08:39:28.000000Z",
"updated_at": "2020-08-27T08:41:31.000000Z"
},
"relationships": {
"supplier": {
"id": "70330f42-9c2c-4aaa-882d-fe46a17f960a",
"type": "supplier"
}
}
},
"included": [
{
"type": "supplier",
"id": "70330f42-9c2c-4aaa-882d-fe46a17f960a",
"attributes": {
"first_name": "Marianne",
"last_name": "A.",
"avatar": null,
"created_at": "2020-03-26T12:00:25.000000Z",
"updated_at": "2020-07-09T10:38:00.000000Z"
}
}
],
"meta": {
"copyright": "Copyright 2020 EasyTranslate A/S",
"environment": "sandbox"
}
}