Get an occurrence
Gets a specific occurrence.
To access this endpoint using an access token
you'll need to specify the /accounts/{accountID}/transfers.read
scope.
|
|
|
|
|
|
|
|
|
|
|
|
{
"properties": {
"canceledOn": {
"format": "date-time",
"type": "string"
},
"error": {
"description": "Contains details on why the occurrence errored.",
"properties": {
"message": {
"type": "string"
}
},
"type": "object"
},
"generated": {
"description": "True if this was generated by a RRule.",
"type": "boolean"
},
"indefinite": {
"description": "True if the RRule set runs indefinitely.",
"type": "boolean"
},
"mode": {
"allOf": [
{
"description": "The operating mode for an account.",
"enum": [
"sandbox",
"production"
],
"example": "production",
"type": "string"
}
],
"description": "Sandbox or production account mode of this schedule."
},
"occurrenceID": {
"format": "uuid",
"type": "string"
},
"ranOn": {
"format": "date-time",
"type": "string"
},
"ranTransferID": {
"format": "uuid",
"type": "string"
},
"runOn": {
"format": "date-time",
"type": "string"
},
"runTransfer": {
"description": "Defines the attributes of a transfer.",
"properties": {
"amount": {
"properties": {
"currency": {
"description": "A 3-letter ISO 4217 currency code.",
"example": "USD",
"pattern": "^[A-Za-z]{3}$",
"type": "string"
},
"value": {
"description": "Quantity in the smallest unit of the specified currency. \n\nIn USD this is cents, for example, $12.04 is 1204 and $0.99 is 99.",
"example": 1204,
"format": "int64",
"type": "integer"
}
},
"required": [
"currency",
"value"
],
"type": "object"
},
"description": {
"description": "Simple description to place on the transfer.",
"type": "string"
},
"destination": {
"properties": {
"achDetails": {
"properties": {
"companyEntryDescription": {
"description": "An optional override of the default NACHA company entry description for a transfer.",
"example": "Gym dues",
"maxLength": 10,
"minLength": 4,
"type": "string"
},
"originatingCompanyName": {
"description": "An optional override of the default NACHA company name for a transfer.",
"example": "Whole Body Fit",
"maxLength": 16,
"minLength": 4,
"type": "string"
}
},
"type": "object"
},
"cardDetails": {
"properties": {
"dynamicDescriptor": {
"description": "An optional override of the default card statement descriptor for a transfer. Accounts must be enabled by Moov to set this field.",
"example": "WhlBdy *Yoga 11-12",
"maxLength": 22,
"minLength": 4,
"type": "string"
}
},
"type": "object"
},
"paymentMethodID": {
"example": "c520f1b9-0ba7-42f5-b977-248cdbe41c69",
"format": "uuid",
"type": "string"
}
},
"required": [
"paymentMethodID"
],
"type": "object"
},
"partnerAccountID": {
"example": "c520f1b9-0ba7-42f5-b977-248cdbe41c69",
"format": "uuid",
"type": "string"
},
"source": {
"properties": {
"achDetails": {
"properties": {
"companyEntryDescription": {
"description": "An optional override of the default NACHA company entry description for a transfer.",
"example": "Gym dues",
"maxLength": 10,
"minLength": 4,
"type": "string"
},
"originatingCompanyName": {
"description": "An optional override of the default NACHA company name for a transfer.",
"example": "Whole Body Fit",
"maxLength": 16,
"minLength": 4,
"type": "string"
}
},
"type": "object"
},
"cardDetails": {
"properties": {
"dynamicDescriptor": {
"description": "An optional override of the default card statement descriptor for a transfer. Accounts must be enabled by Moov to set this field.",
"example": "WhlBdy *Yoga 11-12",
"maxLength": 22,
"minLength": 4,
"type": "string"
}
},
"type": "object"
},
"paymentMethodID": {
"example": "c520f1b9-0ba7-42f5-b977-248cdbe41c69",
"format": "uuid",
"type": "string"
}
},
"required": [
"paymentMethodID"
],
"type": "object"
}
},
"required": [
"amount",
"destination",
"partnerAccountID",
"source",
"description"
],
"type": "object"
},
"scheduleID": {
"format": "uuid",
"type": "string"
},
"status": {
"description": "Status of the completed occurrence.",
"enum": [
"pending",
"failed",
"completed"
],
"type": "string"
}
},
"required": [
"runOn",
"runTransfer"
],
"type": "object"
}
Response headers
x-request-id
string
<uuid>
required
Response headers
x-request-id
string
<uuid>
required
Response headers
x-request-id
string
<uuid>
required
Response headers
x-request-id
string
<uuid>
required
Response headers
x-request-id
string
<uuid>
required
Response headers
x-request-id
string
<uuid>
required
Response headers
x-request-id
string
<uuid>
required
Headers
x-moov-version
string
API version
Specify an API version.
API versioning follows the format vYYYY.QQ.BB
, where
YYYY
is the yearQQ
is the two-digit month for the first month of the quarter (e.g., 01, 04, 07, 10)BB
is the build number, starting at.01
, for subsequent builds in the same quarter.- For example,
v2024.01.00
is the initial release of the first quarter of 2024.
- For example,
The latest
version represents the most recent development state. It may include breaking changes and should be treated as a beta release.
v2024.01.00
Path parameters
accountID
string
<uuid>
required
scheduleID
string
<uuid>
required
occurrenceFilter
string
required
Allows the specification of additional filters beyond the UUID.
Specifying a UUID string returns the exact occurrence.
Specifying a RFC 3339 timestamp returns the latest occurrence at or before that timestamp.
Specifying latest
returns the latest occurrence at or before now.
Response
runOn
string<date-time>
required
runTransfer
object
required
Show child attributes
amount
object
required
Show child attributes
currency
string
required
Pattern
value
integer<int64>
required
Quantity in the smallest unit of the specified currency.
In USD this is cents, for example, $12.04 is 1204 and $0.99 is 99.
description
string
required
destination
object
required
Show child attributes
paymentMethodID
string<uuid>
required
achDetails
object
Show child attributes
companyEntryDescription
string
[4 to 10] characters
originatingCompanyName
string
[4 to 16] characters
cardDetails
object
Show child attributes
dynamicDescriptor
string
[4 to 22] characters
partnerAccountID
string<uuid>
required
source
object
required
Show child attributes
paymentMethodID
string<uuid>
required
achDetails
object
Show child attributes
companyEntryDescription
string
[4 to 10] characters
originatingCompanyName
string
[4 to 16] characters
cardDetails
object
Show child attributes
dynamicDescriptor
string
[4 to 22] characters
canceledOn
string<date-time>
error
object
Show child attributes
message
string
generated
boolean
indefinite
boolean
mode
string
sandbox
,
production
occurrenceID
string<uuid>
ranOn
string<date-time>
ranTransferID
string<uuid>
scheduleID
string<uuid>
status
string<enum>
pending
,
failed
,
completed