---
updatedAt: 2026-08-17T15:14:35.000Z
agentTools:
projectIndex: https://docs.ai-ark.com/llms.txt
---
# Email Finder Submissions
💳 Credit Usage: Free. Your own submission history, including refund status (fullyRefunded, refundReason: STUCK_SOFT_REFUND / STUCK_HARD_REFUND) — check here if a charged job was never delivered (auto-refund within up to 10 hours).
Returns the caller's own Email-Finder submission history, paged and filterable. The list is automatically scoped to the authenticated token's customer — no special role is required.
Each item is a submission summary including its trackId, state, refund status (fullyRefunded, refundReason) and timestamps. refundReason is null unless the submission was fully refunded.
The header Content-Type: application/json must be included in the request.
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "AI Ark",
"version": "1.0.0",
"contact": {}
},
"servers": [
{
"url": "https://api.ai-ark.com/api/developer-portal"
}
],
"paths": {
"/v1/people/email-finder/submissions": {
"get": {
"tags": [
"Email Finder Submissions"
],
"summary": "Email Finder Submissions",
"description": "💳 Credit Usage: Free. Your own submission history, including refund status (fullyRefunded, refundReason: STUCK_SOFT_REFUND / STUCK_HARD_REFUND) — check here if a charged job was never delivered (auto-refund within up to 10 hours).
Returns the caller's own Email-Finder submission history, paged and filterable. The list is automatically scoped to the authenticated token's customer — no special role is required.
Each item is a submission summary including its trackId, state, refund status (fullyRefunded, refundReason) and timestamps. refundReason is null unless the submission was fully refunded.
The header Content-Type: application/json must be included in the request.",
"operationId": "get-email-finder-submissions",
"security": [
{
"Header": []
}
],
"parameters": [
{
"name": "state",
"in": "query",
"required": false,
"description": "Optional filter by submission state.",
"schema": {
"type": "string",
"enum": [
"PENDING",
"SETTLED"
]
},
"example": "SETTLED"
},
{
"name": "fullyRefunded",
"in": "query",
"required": false,
"description": "Optional filter by whether the submission was fully refunded.",
"schema": {
"type": "boolean"
},
"example": true
},
{
"name": "page",
"in": "query",
"required": false,
"description": "Zero-based page index. (>= 0)",
"schema": {
"type": "integer",
"minimum": 0,
"default": 0
},
"example": 0
},
{
"name": "size",
"in": "query",
"required": false,
"description": "Number of items per page. (1 to 100)",
"schema": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 25
},
"example": 25
},
{
"name": "sort",
"in": "query",
"required": false,
"description": "Sort criteria in the format property,(asc|desc). May be specified multiple times.",
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"example": [
"created,desc"
]
}
],
"responses": {
"200": {
"description": "Paged list of submission summaries scoped to the authenticated token",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"content": {
"type": "array",
"items": {
"type": "object",
"properties": {
"trackId": {
"type": "string",
"format": "uuid"
},
"service": {
"type": "string",
"description": "The service that produced the submission.",
"example": "EMAIL_FINDER"
},
"requestSize": {
"type": "integer",
"description": "Number of records requested in the submission."
},
"state": {
"type": "string",
"enum": [
"PENDING",
"SETTLED"
]
},
"fullyRefunded": {
"type": "boolean",
"description": "Whether the submission was fully refunded."
},
"refundReason": {
"type": "string",
"nullable": true,
"description": "Reason the submission was fully refunded; null unless fullyRefunded is true.
SEARCH_NO_RESULTS — Search returned no matching people; request fully refunded.
NO_EMAILS_FOUND — No emails could be found for the matched people; fully refunded.
STUCK_HARD_REFUND — Results not delivered within the time limit; auto-refunded.
STUCK_SOFT_REFUND — Email-finding service did not respond; auto-refunded.",
"enum": [
"SEARCH_NO_RESULTS",
"NO_EMAILS_FOUND",
"STUCK_HARD_REFUND",
"STUCK_SOFT_REFUND"
]
},
"attempts": {
"type": "integer"
},
"created": {
"type": "string",
"format": "date-time"
},
"submittedDate": {
"type": "string",
"format": "date-time",
"nullable": true
},
"doneDate": {
"type": "string",
"format": "date-time",
"nullable": true
},
"settledAt": {
"type": "string",
"format": "date-time",
"nullable": true
}
}
}
},
"pageable": {
"type": "object",
"properties": {
"pageNumber": {
"type": "integer"
},
"pageSize": {
"type": "integer"
},
"sort": {
"type": "object",
"properties": {
"empty": {
"type": "boolean"
},
"sorted": {
"type": "boolean"
},
"unsorted": {
"type": "boolean"
}
}
},
"offset": {
"type": "integer"
},
"paged": {
"type": "boolean"
},
"unpaged": {
"type": "boolean"
}
}
},
"last": {
"type": "boolean"
},
"totalElements": {
"type": "integer"
},
"totalPages": {
"type": "integer"
},
"size": {
"type": "integer"
},
"number": {
"type": "integer"
},
"sort": {
"type": "object",
"properties": {
"empty": {
"type": "boolean"
},
"sorted": {
"type": "boolean"
},
"unsorted": {
"type": "boolean"
}
}
},
"first": {
"type": "boolean"
},
"numberOfElements": {
"type": "integer"
},
"empty": {
"type": "boolean"
}
}
},
"example": {
"content": [
{
"trackId": "74e22d50-95a5-458b-a3f2-9b1e1c1b7bfa",
"service": "EMAIL_FINDER",
"requestSize": 10,
"state": "PENDING",
"fullyRefunded": false,
"refundReason": null,
"attempts": 0,
"created": "2026-06-24T13:13:50.354Z",
"settledAt": null,
"submittedDate": "2026-06-24T13:13:51.578Z",
"doneDate": null
}
],
"pageable": {
"pageNumber": 0,
"pageSize": 25,
"sort": {
"empty": false,
"sorted": true,
"unsorted": false
},
"offset": 0,
"paged": true,
"unpaged": false
},
"last": true,
"totalElements": 1,
"totalPages": 1,
"size": 25,
"number": 0,
"sort": {
"empty": false,
"sorted": true,
"unsorted": false
},
"first": true,
"numberOfElements": 1,
"empty": false
}
}
}
}
}
}
}
},
"components": {
"securitySchemes": {
"Header": {
"type": "apiKey",
"in": "header",
"name": "X-TOKEN"
}
}
},
"security": [
{
"Header": []
}
]
}
```