# Jobs

## Retrieving a list of export jobs

> Retrieves a list of SEPA Export jobs.

```json
{"openapi":"3.0.1","info":{"title":"SEPA Export","version":"0.0.1"},"tags":[{"name":"Jobs"}],"servers":[{"url":"https://api.emporix.io"}],"security":[{"OAuth2":["sepaexport.job_view"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.emporix.io/oauth/token","scopes":{"sepaexport.job_view":"View SEPA export job","sepaexport.job_manage":"Manage SEPA export job","sepaexport.media_view":"View output from SEPA export"}}}}},"schemas":{"JobDetails":{"type":"object","properties":{"jobId":{"type":"string"},"status":{"type":"string"},"siteCode":{"type":"string"},"fileId":{"type":"string"},"active":{"type":"boolean"},"ordersExportedCount":{"type":"integer","format":"int32"},"createdAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time"}}},"errorMessage":{"title":"Error","description":"Schema for specific API errors.","type":"object","properties":{"code":{"type":"integer","description":"HTTP status code.","minimum":100,"maximum":599},"status":{"description":"HTTP status.","type":"string"},"message":{"description":"Descriptive error message for debugging.","type":"string"},"details":{"description":"List of problems causing this error.","type":"array","items":{"title":"Error Detail","description":"Error details.","type":"string"}},"resourceId":{"description":"Id of the resource.","type":"string"}},"required":["status","code","message"]}},"responses":{"BadRequest_400":{"description":"Request syntactically incorrect. Details of the error are included in the response payload.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"_embedded":{"type":"object","properties":{"errors":{"type":"array","items":{"properties":{"message":{"type":"string"},"path":{"type":"string"}}}}}}}}}}},"Unauthorized_401":{"description":"Given request is unauthorized - the authorization token is invalid or has expired. Details will be provided in the response payload.","content":{"application/json":{"schema":{"type":"object","properties":{"fault":{"type":"object","properties":{"faultstring":{"type":"string"},"detail":{"type":"object","properties":{"errorcode":{"type":"string"}}}}}}}}}},"Forbidden_403":{"description":"Given authorization scopes are not sufficient and do not match scopes required by the endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorMessage"}}}}}},"paths":{"/sepa-export/{tenant}/jobs":{"get":{"tags":["Jobs"],"summary":"Retrieving a list of export jobs","description":"Retrieves a list of SEPA Export jobs.","operationId":"GET-sepa-export-list-jobs","parameters":[{"name":"tenant","in":"path","description":"Your Emporix tenant's name.\n**Note**: The `tenant` should always be written in lowercase.","required":true,"schema":{"type":"string"}},{"name":"siteCode","in":"query","description":"Site code, defined when a site is created.\n","required":true,"schema":{"type":"string"}},{"name":"pageNumber","in":"query","description":"Page number to be retrieved. The number of the first page is 1.\n**Note**: If the `pageNumber` parameter is passed, size of the pages must be specified in the `pageSize` parameter.","schema":{"minimum":1,"type":"integer","format":"int32","default":1}},{"name":"pageSize","in":"query","description":"Number of export files to be retrieved per page.","schema":{"minimum":1,"type":"integer","format":"int32","default":16}},{"name":"sort","in":"query","description":"List of properties used to sort the results, separated by commas.\nPossible values:\n* `ASC`\n* `DESC`","schema":{"type":"string","default":"DESC","enum":["ASC","DESC"]}}],"responses":{"200":{"description":"List of jobs","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/JobDetails"}}}}},"400":{"$ref":"#/components/responses/BadRequest_400"},"401":{"$ref":"#/components/responses/Unauthorized_401"},"403":{"$ref":"#/components/responses/Forbidden_403"}}}}}}
```

## Creating a new export job

> Creates a new SEPA Export job.

```json
{"openapi":"3.0.1","info":{"title":"SEPA Export","version":"0.0.1"},"tags":[{"name":"Jobs"}],"servers":[{"url":"https://api.emporix.io"}],"security":[{"OAuth2":["sepaexport.job_manage"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.emporix.io/oauth/token","scopes":{"sepaexport.job_view":"View SEPA export job","sepaexport.job_manage":"Manage SEPA export job","sepaexport.media_view":"View output from SEPA export"}}}}},"schemas":{"CreateJob":{"required":["siteCode"],"type":"object","properties":{"siteCode":{"minLength":1,"type":"string"}}},"JobId":{"required":["id"],"type":"object","properties":{"id":{"type":"string"}}},"errorMessage":{"title":"Error","description":"Schema for specific API errors.","type":"object","properties":{"code":{"type":"integer","description":"HTTP status code.","minimum":100,"maximum":599},"status":{"description":"HTTP status.","type":"string"},"message":{"description":"Descriptive error message for debugging.","type":"string"},"details":{"description":"List of problems causing this error.","type":"array","items":{"title":"Error Detail","description":"Error details.","type":"string"}},"resourceId":{"description":"Id of the resource.","type":"string"}},"required":["status","code","message"]},"ResponseMessage":{"required":["message"],"type":"object","properties":{"message":{"type":"string"}}}},"responses":{"BadRequest_400":{"description":"Request syntactically incorrect. Details of the error are included in the response payload.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"_embedded":{"type":"object","properties":{"errors":{"type":"array","items":{"properties":{"message":{"type":"string"},"path":{"type":"string"}}}}}}}}}}},"Unauthorized_401":{"description":"Given request is unauthorized - the authorization token is invalid or has expired. Details will be provided in the response payload.","content":{"application/json":{"schema":{"type":"object","properties":{"fault":{"type":"object","properties":{"faultstring":{"type":"string"},"detail":{"type":"object","properties":{"errorcode":{"type":"string"}}}}}}}}}},"Forbidden_403":{"description":"Given authorization scopes are not sufficient and do not match scopes required by the endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorMessage"}}}},"Conflict_409":{"description":"Another job is in progress. You can have only one job at the same time.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseMessage"}}}}}},"paths":{"/sepa-export/{tenant}/jobs":{"post":{"tags":["Jobs"],"summary":"Creating a new export job","description":"Creates a new SEPA Export job.","operationId":"POST-sepa-export-create-job","parameters":[{"name":"tenant","in":"path","description":"Your Emporix tenant's name.\n**Note**: The `tenant` should always be written in lowercase.","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Create new job","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateJob"}}},"required":true},"responses":{"201":{"description":"New job ID.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobId"}}}},"400":{"$ref":"#/components/responses/BadRequest_400"},"401":{"$ref":"#/components/responses/Unauthorized_401"},"403":{"$ref":"#/components/responses/Forbidden_403"},"409":{"$ref":"#/components/responses/Conflict_409"}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.emporix.io/api-references-1/readme/api-reference-32/jobs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.