For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

Check recent event ingestion

Checks whether events reached an Amplitude project during a recent time
window. Provide event_type to check one exact event type, or omit it to
check for any event. The default lookback is 10 minutes. The returned
window can begin up to five minutes earlier so the evaluation covers the
complete starting interval.

observed means at least one matching event was found. not_observed
means no matching event was found in the evaluated window. inconclusive
means no matching event was found, but complete recent data was not
available to confirm its absence. Use the returned window when reporting
or comparing results.

This POST computes a result and does not mutate state, so it does not
require an Idempotency-Key.

Provide polling_timeout_seconds to request server polling guidance.
While another check is advised, successful responses include
poll_after_seconds; its omission means clients should stop polling.

post/v1/projects/{project_id}/events/check-recent-ingestion

Authorizations

Authorizationstringrequired

http

Path parameters

project_idstringrequired

Amplitude project identifier, backed by the canonical app ID.

Example:12345
Constraints:pattern: ^[0-9]+$

Body

application/json
event_typestring

Exact event type to check. Omit to check for any event.

Constraints:pattern: \S
lookback_minutesinteger

Number of recent minutes to evaluate. The returned window can begin up to five minutes earlier to cover the complete starting interval.

Default:10
Constraints:min: 1max: 1440
polling_timeout_secondsinteger

Maximum polling window requested by the caller. Clients should complete the initial check even if it exceeds this window and use the window only to limit subsequent polls. Its presence requests polling guidance; it is not an HTTP request timeout, and each HTTP request performs one check.

Constraints:min: 1max: 120

Response

application/json
200· Ingestion check completed successfully.
dataobjectrequired
Show child attributes
idstringrequired

Identifier for this ingestion check.

objectstringrequired

Resource-type discriminator. Always recent_event_ingestion_check.

project_idstringrequired
Constraints:pattern: ^[0-9]+$
event_typestring

Event type evaluated. Omitted when the request checked for any event.

statusstringrequired

observed when at least one matching event was found; not_observed when none was found; inconclusive when none was found but complete recent data was unavailable.

Allowed values:observednot_observedinconclusive
countnumberrequired

Number of matching events found in the evaluated window.

Constraints:min: 0
poll_after_secondsinteger

Minimum seconds to wait before the next ingestion check. Returned only when polling was requested and another check is advised. Its omission means the server does not advise another check.

Constraints:min: 1
windowobjectrequired
startstringrequired

Start of the evaluated window.

Constraints:format: date-time
endstringrequired

End of the evaluated window.

Constraints:format: date-time
basisstringrequired

Time basis for the window. server_upload_time measures when an event reached Amplitude.

403· The caller cannot use this operation. operation_not_enabled means the operation is not enabled for the caller's organization; insufficient_scope means the token lacks analytics:read.
typestringrequired
Constraints:format: uri
titlestringrequired
statusintegerrequired
Constraints:min: 400max: 599
detailstring
Constraints:nullable
instancestring
Constraints:format: urinullable
error_codestringrequired
retryablebooleanrequired
retry_after_secondsinteger
Constraints:nullablemin: 0
validation_errorsobject[]
Constraints:nullable
502· The ingestion status could not be determined. Retryable responses use event_type_not_queryable, unreliable_dataset_response, or upstream_error as the error_code.
typestringrequired
Constraints:format: uri
titlestringrequired
statusintegerrequired
Constraints:min: 400max: 599
detailstring
Constraints:nullable
instancestring
Constraints:format: urinullable
error_codestringrequired
retryablebooleanrequired
retry_after_secondsinteger
Constraints:nullablemin: 0
validation_errorsobject[]
Constraints:nullable
503· Endpoint not available.
typestringrequired
Constraints:format: uri
titlestringrequired
statusintegerrequired
Constraints:min: 400max: 599
detailstring
Constraints:nullable
instancestring
Constraints:format: urinullable
error_codestringrequired
retryablebooleanrequired
retry_after_secondsinteger
Constraints:nullablemin: 0
validation_errorsobject[]
Constraints:nullable

Was this helpful?