Project tasks
      Back to home
      1. Knowledge Base
      2. EasyTranslate API
      3. Project tasks

      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"
        }
      }