List network bulk feed

URL Expired

The URL for this request expired after 30 days.

API Parameters

• networkReference: string
• subaccountId: uuid
• limit: integer (1 to 100)
  • Defaults to 25
  • Maximum number of items to return
• offset: number
  • Defaults to 0
  • The offset to use for pagination. Identifies the position of the first item returned in the collection
• accept: string (enum)
  • Defaults to application/hal+json
  • Allowed: application/hal+json, application/problem+json

Responses

200 Successful operation

• object
  • _links: object (required)
    • self: object (required)
    • first: object
    • next: object
    • prev: object
    • last: object
  • _embedded: object (required)
    • networkBulkFeeds: array of objects (required)
      • networkBulkFeeds*: object
        • _links: object (required)
        • id: uuid (required) - The unique identifier of this network bulk feed entity.
        • subaccountId: uuid (required) - The unique identifier of the subaccount related to this entity.
        • network: string (enum) (required) - The network where the feed belongs.
          • AMEX, MASTERCARD, VISA
        • networkReference: string (required) - The identifier associated with the card network's bulk enrollment feed.
        • state: string (enum) (required) - The state of the network bulk feed entity.
          • Note: The failed state is only applicable to VISA bulk feeds. submitted, active, deactivated, failed
        • type: string (enum) (required) - GL, SMARTDATA, VBDS, VCF
        • errorReason: string | null - A human-readable reason explaining why the bulk feed failed. Only present when state is failed.
          • Note: Only applicable to VISA bulk feeds.
        • expectedCardCount: integer (1 to 1000000) - The expected number of cards that will be enrolled under this bulk feed, as provided at creation time.
        • createdAt: date-time (required) - Date and time when this resource was created, in UTC, following ISO 8601 format.
        • updatedAt: date-time (required) - Date and time when this resource was last updated, in UTC, following ISO 8601 format.
  • totalItems: integer (required) - Total number of network bulk feeds

Error Codes

• 400: The server cannot or will not process the request due to a client error.
• 401: Authentication credentials were either missing or incorrect.
• 403: Authentication credentials used do not have permissions to perform the request.
• 500: The server encountered an unexpected condition that prevented it from fulfilling the request.

Curl Example

curl --request GET \
     --url 'https://api.astrada.co/network-bulk-feeds?limit=25&offset=0' \
     --header 'accept: application/hal+json'

Example Response

{
  "_links": {
    "self": {
      "href": "/network-bulk-feeds"
    }
  },
  "_embedded": {
    "networkBulkFeeds": [
      {
        "_links": {
          "self": {
            "href": "/network-bulk-feeds/75ea3c99-6bf5-4b16-8f68-0cdc43d75806"
          }
        },
        "id": "75ea3c99-6bf5-4b16-8f68-0cdc43d75806",
        "subaccountId": "f297d659-c13d-4219-aeaa-e10a845140a5",
        "network": "MASTERCARD",
        "networkReference": "G1234567",
        "state": "submitted",
        "type": "SMARTDATA",
        "createdAt": "2024-12-19T14:45:00Z",
        "updatedAt": "2024-12-19T14:45:00Z"
      },
      {
        "_links": {
          "self": {
            "href": "/network-bulk-feeds/c73f2da7-aa1f-4775-ad38-864b1b6f3162"
          }
        },
        "id": "c73f2da7-aa1f-4775-ad38-864b1b6f3162",
        "subaccountId": "29cb4277-b812-4137-b008-e0befa8c6a47",
        "network": "MASTERCARD",
        "networkReference": "G1234567",
        "state": "submitted",
        "type": "SMARTDATA",
        "createdAt": "2024-10-19T14:45:00Z",
        "updatedAt": "2024-10-19T14:45:00Z"
      },
      {
        "_links": {
          "self": {
            "href": "/network-bulk-feeds/a3b1c2d4-5e6f-7890-abcd-ef1234567890"
          }
        },
        "id": "a3b1c2d4-5e6f-7890-abcd-ef1234567890",
        "subaccountId": "f297d659-c13d-4219-aeaa-e10a845140a5",
        "network": "VISA",
        "networkReference": 119999789452,
        "state": "failed",
        "type": "VBDS",
        "errorReason": "Starter data ingestion failed: invalid RPIC configuration",
        "createdAt": "2024-12-19T14:45:00Z",
        "updatedAt": "2024-12-20T10:30:00Z"
      }
    ]
  },
  "totalItems": 3
}