curl -X 'GET' \
  'https://api.prd.amini.ai/public/api/v1/polygons/INSERT YOUR JOB ID HERE' \
  -H 'accept: application/json' \
  -H 'x-api-key: INSERT YOUR API KEY HERE'

{
  "data": [
    {
      "polygon": "MULTIPOLYGON (((27.4519994961939 -15.1579219611942,27.452054058582 -15.1576347062685,27.4523011941047 -15.1576395205968,27.452291565448 -15.1580760197018,27.4519994961939 -15.1579219611942)))",
      "end_date": "2022-05-28",
      "NDVI_mean": 0.0637667253613472,
      "start_date": "2021-12-10"
    },
    {
      "polygon": "MULTIPOLYGON (((28.7365767 -11.8240733,28.7364867 -11.8238926,28.7367433 -11.8238783,28.736855 -11.82404,28.7365767 -11.8240733)))",
      "end_date": "2022-06-10",
      "NDVI_mean": 0.2758926451206207,
      "start_date": "2021-12-28"
    },
    {
      "polygon": "MULTIPOLYGON (((27.4711853035008 -15.1040251278885,27.4704200081892 -15.1052234192317,27.4697453399539 -15.1051227224802,27.4705307746159 -15.1038338040605,27.4707120287686 -15.1038740827612,27.4711853035008 -15.1040251278885)))",
      "end_date": "2022-05-27",
      "NDVI_mean": 0.06767917424440384,
      "start_date": "2021-11-27"
    },
    {
      "polygon": "MULTIPOLYGON (((27.3799696578554 -16.6085596208197,27.3796739961156 -16.6090587110464,27.3794624842556 -16.6091916562592,27.3795466341354 -16.6084920582876,27.3799696578554 -16.6085596208197)))",
      "end_date": "2022-05-09",
      "NDVI_mean": 0.15575826168060303,
      "start_date": "2021-12-23"
    },
    {
      "polygon": "MULTIPOLYGON (((29.51611 -11.37622,29.5165383 -11.376255,29.51659 -11.3766233,29.51608 -11.3766467,29.51611 -11.37622)))",
      "end_date": "2022-06-18",
      "NDVI_mean": 0.16876965761184692,
      "start_date": "2021-12-06"
    },
    {
      "polygon": "MULTIPOLYGON (((24.9341801 -14.4941319,24.9344875488932 -14.4936835587698,24.9354967 -14.494251,24.9351183 -14.494635,24.9341783 -14.4941367,24.9341801 -14.4941319)))",
      "end_date": "2022-06-14",
      "NDVI_mean": 0.18428558111190796,
      "start_date": "2021-12-14"
    }
  ],
  "err_data": {
    "Error processing item: {\"code\":\"BadRequest\",\"description\":\"\\\"invalid_shape_exception: Provided shape has duplicate consecutive coordinates at: (POINT (26.5616755 -12.229643))\\\"\"}": [
      {
        "message": "Error processing item: {\"code\":\"BadRequest\",\"description\":\"\\\"invalid_shape_exception: Provided shape has duplicate consecutive coordinates at: (POINT (26.5616755 -12.229643))\\\"\"}",
        "polygon": "MULTIPOLYGON (((26.5616281 -12.2296526,26.5616348 -12.2296568,26.5616555 -12.2296428,26.5616591 -12.229641,26.5616643 -12.2296414,26.5616697 -12.2296392,26.5616748 -12.2296409,26.5616761 -12.229643,26.561676 -12.2296431,26.5616757 -12.2296431,26.5616755 -12.2296431,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616868 -12.229655,26.5617085 -12.2296781,26.5617172 -12.2296769,26.5617303 -12.2296694,26.5617367 -12.2296605,26.5617378 -12.2296577,26.5617374 -12.2296566,26.5617354 -12.2296572,26.5617346 -12.2296575,26.5617346 -12.2296575,26.5617342 -12.2296577,26.561734 -12.2296578,26.5617393 -12.2296478,26.561739 -12.2296417,26.5617419 -12.2296339,26.5617453 -12.2296259,26.5617505 -12.2296164,26.5617565 -12.229599,26.5617635 -12.2295828,26.5617723 -12.2295624,26.5617744 -12.2295514,26.5617771 -12.2295427,26.561779 -12.2295283,26.5617821 -12.2295145,26.5617873 -12.2294942,26.5617907 -12.229482,26.5618011 -12.2294753,26.5618096 -12.2294751,26.5618213 -12.2294743,26.5618289 -12.2294757,26.5618357 -12.2294765,26.5618525 -12.2294777,26.5618685 -12.229479,26.5618902 -12.2294812,26.5619043 -12.2294823,26.5619183 -12.2294836,26.5619324 -12.2294857,26.5619562 -12.2294875,26.5619613 -12.2294898,26.561973 -12.229493,26.561987 -12.2294984,26.5620007 -12.2295033,26.5620214 -12.2295091,26.5620346 -12.2295138,26.5620526 -12.2295212,26.5620678 -12.2295264,26.5620884 -12.2295326,26.562101 -12.2295361,26.5621162 -12.2295389,26.5621326 -12.2295425,26.5621628 -12.2295491,26.5621753 -12.2295507,26.56219 -12.2295535,26.5622023 -12.2295569,26.5622192 -12.2295616,26.5622348 -12.2295671,26.5622486 -12.229572,26.5622629 -12.229577,26.5622744 -12.2295878,26.5622716 -12.2295995,26.5622644 -12.2296124,26.5622499 -12.2296269,26.5622406 -12.2296415,26.5622359 -12.2296522,26.5622308 -12.2296655,26.5622269 -12.2296786,26.5622188 -12.2297035,26.5622138 -12.2297135,26.5622083 -12.2297251,26.5621995 -12.2297399,26.5621886 -12.2297576,26.5621836 -12.2297684,26.5621812 -12.2297817,26.5621816 -12.2297981,26.5621842 -12.2298218,26.5621868 -12.2298319,26.5621873 -12.2298467,26.5621875 -12.2298597,26.5621836 -12.2298813,26.5621813 -12.229886,26.5621781 -12.2298955,26.5621758 -12.2299043,26.5621731 -12.2299168,26.5621726 -12.2299301,26.5621731 -12.2299409,26.5621713 -12.2299498,26.5621693 -12.2299571,26.5621651 -12.2299687,26.562167 -12.2299688,26.5616281 -12.2296526)))",
        "end_date": "2022-05-21",
        "start_date": "2022-01-19"
      }
    ]
  }
}
The current release available from the Amini Data Platform is released on .
https://api.prd.amini.ai/public/api/v1/polygons{job_id}

​
Introduction

Use this API endpoint to get the data you’ve processed for a given set of geopolygons, timeframe and parameters requested, using the Job ID, which you can get from the Data Request API endpoint (post/polygons) or the Data Catalog.

You can always come back to the Jobs History in order to get the Job ID from all jobs associated with your account.

​
Request Headers

Assuming you have your Job ID, either from the API directly or the webpage, you can now proceed with getting the requested data for each Job ID.

​
x-api-key
string

A unique identifier used to authenticate the API request. This key is provided to developers upon registration and should be kept confidential.

​
job_id
string

A unique identifier for the data request job generated after uploading your own geopolygon for the query.

  curl -X 'GET' \
  'https://api.prd.amini.ai/public/api/v1/polygons/INSERT YOUR JOB ID HERE' \
  -H 'accept: application/json' \
  -H 'x-api-key: INSERT YOUR API KEY HERE'

​
Response

​
polygon
string

The geopolygon (e.g., point or polygon) that was uploaded.

​
end_date
string

The end date for the processed data request in the format YYYY-MM-DD.

​
start_date
string

The start date for the processed data request in the format YYYY-MM-DD.

{
  "data": [
    {
      "polygon": "MULTIPOLYGON (((27.4519994961939 -15.1579219611942,27.452054058582 -15.1576347062685,27.4523011941047 -15.1576395205968,27.452291565448 -15.1580760197018,27.4519994961939 -15.1579219611942)))",
      "end_date": "2022-05-28",
      "NDVI_mean": 0.0637667253613472,
      "start_date": "2021-12-10"
    },
    {
      "polygon": "MULTIPOLYGON (((28.7365767 -11.8240733,28.7364867 -11.8238926,28.7367433 -11.8238783,28.736855 -11.82404,28.7365767 -11.8240733)))",
      "end_date": "2022-06-10",
      "NDVI_mean": 0.2758926451206207,
      "start_date": "2021-12-28"
    },
    {
      "polygon": "MULTIPOLYGON (((27.4711853035008 -15.1040251278885,27.4704200081892 -15.1052234192317,27.4697453399539 -15.1051227224802,27.4705307746159 -15.1038338040605,27.4707120287686 -15.1038740827612,27.4711853035008 -15.1040251278885)))",
      "end_date": "2022-05-27",
      "NDVI_mean": 0.06767917424440384,
      "start_date": "2021-11-27"
    },
    {
      "polygon": "MULTIPOLYGON (((27.3799696578554 -16.6085596208197,27.3796739961156 -16.6090587110464,27.3794624842556 -16.6091916562592,27.3795466341354 -16.6084920582876,27.3799696578554 -16.6085596208197)))",
      "end_date": "2022-05-09",
      "NDVI_mean": 0.15575826168060303,
      "start_date": "2021-12-23"
    },
    {
      "polygon": "MULTIPOLYGON (((29.51611 -11.37622,29.5165383 -11.376255,29.51659 -11.3766233,29.51608 -11.3766467,29.51611 -11.37622)))",
      "end_date": "2022-06-18",
      "NDVI_mean": 0.16876965761184692,
      "start_date": "2021-12-06"
    },
    {
      "polygon": "MULTIPOLYGON (((24.9341801 -14.4941319,24.9344875488932 -14.4936835587698,24.9354967 -14.494251,24.9351183 -14.494635,24.9341783 -14.4941367,24.9341801 -14.4941319)))",
      "end_date": "2022-06-14",
      "NDVI_mean": 0.18428558111190796,
      "start_date": "2021-12-14"
    }
  ],
  "err_data": {
    "Error processing item: {\"code\":\"BadRequest\",\"description\":\"\\\"invalid_shape_exception: Provided shape has duplicate consecutive coordinates at: (POINT (26.5616755 -12.229643))\\\"\"}": [
      {
        "message": "Error processing item: {\"code\":\"BadRequest\",\"description\":\"\\\"invalid_shape_exception: Provided shape has duplicate consecutive coordinates at: (POINT (26.5616755 -12.229643))\\\"\"}",
        "polygon": "MULTIPOLYGON (((26.5616281 -12.2296526,26.5616348 -12.2296568,26.5616555 -12.2296428,26.5616591 -12.229641,26.5616643 -12.2296414,26.5616697 -12.2296392,26.5616748 -12.2296409,26.5616761 -12.229643,26.561676 -12.2296431,26.5616757 -12.2296431,26.5616755 -12.2296431,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616755 -12.229643,26.5616868 -12.229655,26.5617085 -12.2296781,26.5617172 -12.2296769,26.5617303 -12.2296694,26.5617367 -12.2296605,26.5617378 -12.2296577,26.5617374 -12.2296566,26.5617354 -12.2296572,26.5617346 -12.2296575,26.5617346 -12.2296575,26.5617342 -12.2296577,26.561734 -12.2296578,26.5617393 -12.2296478,26.561739 -12.2296417,26.5617419 -12.2296339,26.5617453 -12.2296259,26.5617505 -12.2296164,26.5617565 -12.229599,26.5617635 -12.2295828,26.5617723 -12.2295624,26.5617744 -12.2295514,26.5617771 -12.2295427,26.561779 -12.2295283,26.5617821 -12.2295145,26.5617873 -12.2294942,26.5617907 -12.229482,26.5618011 -12.2294753,26.5618096 -12.2294751,26.5618213 -12.2294743,26.5618289 -12.2294757,26.5618357 -12.2294765,26.5618525 -12.2294777,26.5618685 -12.229479,26.5618902 -12.2294812,26.5619043 -12.2294823,26.5619183 -12.2294836,26.5619324 -12.2294857,26.5619562 -12.2294875,26.5619613 -12.2294898,26.561973 -12.229493,26.561987 -12.2294984,26.5620007 -12.2295033,26.5620214 -12.2295091,26.5620346 -12.2295138,26.5620526 -12.2295212,26.5620678 -12.2295264,26.5620884 -12.2295326,26.562101 -12.2295361,26.5621162 -12.2295389,26.5621326 -12.2295425,26.5621628 -12.2295491,26.5621753 -12.2295507,26.56219 -12.2295535,26.5622023 -12.2295569,26.5622192 -12.2295616,26.5622348 -12.2295671,26.5622486 -12.229572,26.5622629 -12.229577,26.5622744 -12.2295878,26.5622716 -12.2295995,26.5622644 -12.2296124,26.5622499 -12.2296269,26.5622406 -12.2296415,26.5622359 -12.2296522,26.5622308 -12.2296655,26.5622269 -12.2296786,26.5622188 -12.2297035,26.5622138 -12.2297135,26.5622083 -12.2297251,26.5621995 -12.2297399,26.5621886 -12.2297576,26.5621836 -12.2297684,26.5621812 -12.2297817,26.5621816 -12.2297981,26.5621842 -12.2298218,26.5621868 -12.2298319,26.5621873 -12.2298467,26.5621875 -12.2298597,26.5621836 -12.2298813,26.5621813 -12.229886,26.5621781 -12.2298955,26.5621758 -12.2299043,26.5621731 -12.2299168,26.5621726 -12.2299301,26.5621731 -12.2299409,26.5621713 -12.2299498,26.5621693 -12.2299571,26.5621651 -12.2299687,26.562167 -12.2299688,26.5616281 -12.2296526)))",
        "end_date": "2022-05-21",
        "start_date": "2022-01-19"
      }
    ]
  }
}