Submissions API#

Submit to Store#

POST /v1/projects/:id/submit — Requires authentication

Submits a project to the App Store, Google Play, or both. Requires store credentials to be configured in your project settings.

Path Parameters#

| Name | Type | Required | Description | |------|------|----------|-------------| | id | string | Yes | The project ID. |

Request Body#

| Name | Type | Required | Description | |------|------|----------|-------------| | store | string | Yes | Target store: 'app_store', 'play_store', or 'both'. | | dryRun | boolean | No | If true, validates the submission without actually submitting. Defaults to false. |

Response#

{
  "submissionId": "sub_ghi012",
  "status": "submitted",
  "store": "app_store",
  "submittedAt": "2026-03-28T12:00:00Z"
}

Dry Run Response#

When dryRun is true, the response includes validation results instead of submitting:

{
  "submissionId": "sub_ghi012",
  "status": "validated",
  "store": "app_store",
  "dryRun": true,
  "validationResults": {
    "passed": true,
    "errors": [],
    "warnings": ["Consider adding more keywords to improve discoverability."]
  }
}

Warning: Without dryRun: true, this endpoint will submit your app for real. Make sure your screenshots, metadata, and compliance are all ready. Use dry-run mode to validate first.

Example#

curl -X POST \
  -H "Authorization: Bearer sk_stora_..." \
  -H "Content-Type: application/json" \
  -d '{"store": "app_store", "dryRun": true}' \
  https://stora.sh/api/v1/projects/proj_abc123/submit

Get Review Status#

GET /v1/projects/:id/status — Requires authentication

Returns the current review status for a project's most recent submission.

Path Parameters#

| Name | Type | Required | Description | |------|------|----------|-------------| | id | string | Yes | The project ID. |

Response#

{
  "store": "app_store",
  "status": "in_review",
  "submissionId": "sub_ghi012",
  "submittedAt": "2026-03-27T14:00:00Z",
  "estimatedReviewTime": "24-48 hours"
}

Status Values#

| Status | Description | |---|---| | preparing | Submission is being prepared. | | submitted | Successfully submitted to the store. | | waiting_for_review | In the review queue. | | in_review | Currently being reviewed. | | approved | Approved and ready for release. | | rejected | Rejected. Check rejectionReasons in the response. |

Example#

curl -H "Authorization: Bearer sk_stora_..." \
  https://stora.sh/api/v1/projects/proj_abc123/status