# Executions

## GET Execution

> Retrieve specific fill by execution ID.

```json
{"openapi":"3.0.3","info":{"title":"Aquanow CAMS REST API","version":"1.0"},"servers":[{"url":"https://cams.aquanow.com/api","description":"production"},{"url":"http://localhost:3001/api","description":"local"},{"url":"https://camsapi-dev.aquanow.com/api","description":"dev"},{"url":"https://camsapi-staging.aquanow.com/api","description":"staging"},{"url":"https://cams.cert.aquanow.com/api","description":"cert"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer"}},"schemas":{"Execution":{"title":"Execution","type":"object","properties":{"executionId":{"type":"string","format":"uuid"},"orderId":{"type":"string","format":"uuid"},"accountId":{"type":"string","format":"uuid"},"executedAt":{"type":"string","format":"date-time"},"pair":{"type":"string"},"side":{"type":"string"},"orderType":{"$ref":"#/components/schemas/OrderType"},"deliverCurrency":{"type":"string"},"deliverQuantity":{"type":"string"},"receiveCurrency":{"type":"string"},"receiveQuantity":{"type":"string"},"price":{"type":"string","format":"number"},"baseQuantity":{"type":"string","format":"number"},"quoteQuantity":{"type":"string","format":"number"},"clientFeeRate":{"type":"string","format":"integer","nullable":true},"clientFeeAmount":{"type":"string","format":"number","description":"Fixed fiat fee amount in tenant native currency","nullable":true},"providerFeeRate":{"type":"string","format":"integer"},"clientFeeQuantity":{"type":"string","format":"number"},"providerFeeQuantity":{"type":"string","format":"number"},"feeCurrency":{"type":"string"},"executionStatus":{"$ref":"#/components/schemas/ExecutionStatus"},"tradeDate":{"type":"string","format":"date"},"valueDate":{"type":"string","format":"date"},"confirmedAt":{"type":"string","format":"date-time","nullable":true},"clientReference":{"type":"string","nullable":true},"tradeTaxRate":{"type":"string","format":"number","description":"Tax rate charged on fees as a percentage"},"clientTaxQuantity":{"type":"string","format":"number"},"providerTaxQuantity":{"type":"string","format":"number"}}},"OrderType":{"type":"string","enum":["MARKET","LIMIT","PREVIOUSLY_QUOTED"]},"ExecutionStatus":{"type":"string","enum":["TRADE_EXECUTED","TRADE_CONFIRMED","TRADE_SETTLED"]}},"responses":{"400":{"description":"Validation Error"},"401":{"description":"Unauthorized"},"403":{"description":"Insufficient Privileges"},"4XX":{"description":"Client error"},"5XX":{"description":"Server error"}}},"paths":{"/v1/executions/{executionId}":{"get":{"summary":"GET Execution","description":"Retrieve specific fill by execution ID.","tags":["Trading"],"parameters":[{"name":"executionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"The execution ID returned by the executeQuote endpoint"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Execution"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"4XX":{"$ref":"#/components/responses/4XX"},"5XX":{"$ref":"#/components/responses/5XX"}},"operationId":"GetOneExecution"}}}}
```

## GET Executions

> Retrieve fills with optional filtering and pagination.

```json
{"openapi":"3.0.3","info":{"title":"Aquanow CAMS REST API","version":"1.0"},"servers":[{"url":"https://cams.aquanow.com/api","description":"production"},{"url":"http://localhost:3001/api","description":"local"},{"url":"https://camsapi-dev.aquanow.com/api","description":"dev"},{"url":"https://camsapi-staging.aquanow.com/api","description":"staging"},{"url":"https://cams.cert.aquanow.com/api","description":"cert"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer"}},"schemas":{"ExecutionStatus":{"type":"string","enum":["TRADE_EXECUTED","TRADE_CONFIRMED","TRADE_SETTLED"]},"SortDirection":{"type":"string","enum":["ASC","DESC"]},"Execution":{"title":"Execution","type":"object","properties":{"executionId":{"type":"string","format":"uuid"},"orderId":{"type":"string","format":"uuid"},"accountId":{"type":"string","format":"uuid"},"executedAt":{"type":"string","format":"date-time"},"pair":{"type":"string"},"side":{"type":"string"},"deliverCurrency":{"type":"string"},"deliverQuantity":{"type":"string"},"receiveCurrency":{"type":"string"},"receiveQuantity":{"type":"string"},"price":{"type":"string","format":"number"},"baseQuantity":{"type":"string","format":"number"},"quoteQuantity":{"type":"string","format":"number"},"clientFeeRate":{"type":"string","format":"integer"},"providerFeeRate":{"type":"string","format":"integer"},"clientFeeQuantity":{"type":"string","format":"number"},"providerFeeQuantity":{"type":"string","format":"number"},"feeCurrency":{"type":"string"},"executionStatus":{"$ref":"#/components/schemas/ExecutionStatus"},"tradeDate":{"type":"string","format":"date"},"valueDate":{"type":"string","format":"date"},"confirmedAt":{"type":"string","format":"date-time","nullable":true},"clientReference":{"type":"string","nullable":true},"tradeTaxRate":{"type":"string","format":"number","description":"Tax rate charged on fees as a percentage"},"clientTaxQuantity":{"type":"string","format":"number"},"providerTaxQuantity":{"type":"string","format":"number"}}}},"responses":{"400":{"description":"Validation Error"},"401":{"description":"Unauthorized"},"403":{"description":"Insufficient Privileges"},"4XX":{"description":"Client error"},"5XX":{"description":"Server error"}}},"paths":{"/v1/executions":{"get":{"summary":"GET Executions","description":"Retrieve fills with optional filtering and pagination.","parameters":[{"name":"executionStatus","in":"query","schema":{"$ref":"#/components/schemas/ExecutionStatus"},"description":"Filter executions by execution status"},{"name":"orderId","in":"query","schema":{"type":"string","format":"uuid"},"description":"Filter executions by order ID."},{"name":"clientReference","in":"query","schema":{"type":"string"},"description":"Filter executions by client provided reference parameter"},{"name":"accountId","in":"query","schema":{"type":"string","format":"uuid"},"description":"Filter executions by account ID"},{"name":"tradeDateStart","in":"query","schema":{"type":"string","format":"date"},"description":"Filter executions by trade date lower bound, exclusive"},{"name":"tradeDateEnd","in":"query","schema":{"type":"string","format":"date"},"description":"Filter executions by trade date upper bound, inclusive"},{"name":"valueDateStart","in":"query","schema":{"type":"string","format":"date"},"description":"Filter executions by value date lower bound, exclusive"},{"name":"valueDateEnd","in":"query","schema":{"type":"string","format":"date"},"description":"Filter executions by value date upper bound, inclusive"},{"name":"after","in":"query","required":false,"schema":{"type":"string"},"description":"When provided, specifies the last item returned in previous page, used to fetch the next page. Fetches the first page when omitted."},{"name":"limit","in":"query","required":false,"schema":{"type":"string","format":"integer"},"description":"When provided, specifies the number of items to return in the page. Uses default page size of 10 when omitted."},{"name":"sortField","in":"query","required":false,"schema":{"type":"string","enum":["tradeDate","valueDate","executionStatus"]},"description":"Will sort the returned data using the specified field."},{"name":"sortDirection","in":"query","required":false,"schema":{"$ref":"#/components/schemas/SortDirection"},"description":"Specifies the sort direction for the sortField."},{"schema":{"type":"string"},"in":"query","name":"side","description":"Filter orders by side."},{"schema":{"type":"string"},"in":"query","name":"pair","description":"Filter executions by trade pair."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"after":{"type":"string","nullable":true,"description":"The token of the last item in the response"},"totalCount":{"type":"string","format":"integer","description":"The total number of items in the entire filtered data set"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Execution"}}}}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"4XX":{"$ref":"#/components/responses/4XX"},"5XX":{"$ref":"#/components/responses/5XX"}},"operationId":"GetAllExecutions"}}}}
```