Omnichannel File Status API Objects | Omnichannel file status |Preview of Tealium Docs

This is an older version of the current Tealium Omnichannel File Status API.

The API returns a File Status that details when the files imported and how they were processed, including any processing errors. A File Status is represented as a JSON object containing the following keys:

Name	Type	Description
account	string	Name of the AudienceStream account
profile	string	Name of the profile (in the account) where your files are uploaded and processed
created at	UTC timestamp	date and time when the file status was created (expressed in UTC format with the designator ‘Z’)
file.name	string	Name of the file in question
file.size	integer	File size in bytes
file.source-type	string	Service used for uploading the file: FTP, SFTP, Tealium S3, and S3
file.source-host	string	Name of the service * Hosting account for FTP/SFTP * Bucket name for S3/Tealium S3
line_count	integer	Number of rows in the file
status.state	string	Indicates the processing action on the file. Possible values are: DOWNLOADING, DOWNLOADED, PROCESSING, or PROCESSED.
status.timestamp	UTC timestamp	date and time when the [status-state] was recorded (expressed in UTC format with the designator ‘Z’)
lines_successfully_processed	integer	Number of rows parsed successfully
lines_skipped	integer	Number of rows that could not be parsed due to missing data
lines_failed_processing	integer	Number of rows that could not be parsed due to bad data or incorrect formatting
last_failure	string	Error due to which the row/file could not be processed (Refer to Error Glossary and Troubleshooting link_here)

Sample File Status

{
    "account": "company_xyz",
    "created_at": {
      "$date": "2016-04-04T22:27:56.993Z"
    },
    "file": {
      "name": "sales-transaction_2016feb4v50.csv",
      "size": 2744,
      "checksum": "44b12d35ea9fffdeeb69f98b03004f22",
      "source": {
        "type": "s3",
        "host": "companyxyz:"
      },
      "line_count": 35
    },
    "node_id": "bulk_downloader_i-cd504b49",
    "profile": "omnichannelv2",
    "status": [
      {
        "state": "DOWNLOADING",
        "timestamp": {
          "$date": "2016-04-04T22:27:57.285Z"
        }
      },
      {
        "state": "DOWNLOADED",
        "timestamp": {
          "$date": "2016-04-04T22:27:57.722Z"
        }
      },
      {
        "state": "PROCESSING",
        "timestamp": {
          "$date": "2016-04-04T22:27:57.780Z"
        },
        "lines_skipped": 34

      },
      {
        "state": "PROCESSED",
        "timestamp": {
          "$date": "2016-04-04T22:27:58.797Z"
        }
      }
    ]
}