v4

latestSwagger 2.02026-08-0343714211.7 MB
as2_incoming_messages
AS2 Incoming Messages

List AS2 Incoming Messages

List AS2 Incoming Messages

get/as2_incoming_messages

Query parameters

cursorstring

Used for pagination. When a list request has more records available, cursors are provided in the response headers X-Files-Cursor-Next and X-Files-Cursor-Prev. Send one of those cursor value here to resume an existing list from the next available record. Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.

per_pageinteger

Number of records to show per page. (Max: 10000, 1,000 or less is recommended).

If set, sort records by the specified field in either asc or desc direction. Valid fields are workspace_id, created_at or as2_partner_id.

If set, return records where the specified field is equal to the supplied value. Valid fields are created_at, as2_station_id, workspace_id or as2_partner_id. Valid field combinations are [ as2_station_id, created_at ], [ workspace_id, created_at ], [ as2_partner_id, created_at ], [ workspace_id, as2_station_id ], [ workspace_id, as2_partner_id ], [ workspace_id, as2_station_id, created_at ] or [ workspace_id, as2_partner_id, created_at ].

If set, return records where the specified field is greater than the supplied value. Valid fields are created_at.

If set, return records where the specified field is greater than or equal the supplied value. Valid fields are created_at.

If set, return records where the specified field is less than the supplied value. Valid fields are created_at.

If set, return records where the specified field is less than or equal the supplied value. Valid fields are created_at.

Response

A list of As2IncomingMessages objects.

idinteger

Id of the AS2 Partner.

workspace_idinteger

ID of the Workspace associated with this AS2 Incoming Message.

as2_partner_idinteger

Id of the AS2 Partner associated with this message.

as2_station_idinteger

Id of the AS2 Station associated with this message.

uuidstring

UUID assigned to this message.

content_typestring

Content Type header of the incoming message.

http_headersobject

HTTP Headers sent with this message.

processing_result'not_started' | 'unable_to_find_station' | 'unable_to_find_partner' | 'unable_to_validate_signature' | 'decrypt_fail' | 'file_save_fail' | 'success'

Result of processing.

processing_result_descriptionstring

Result of processing description.

micstring

AS2 Message Integrity Check

mic_algostring

AS2 Message Integrity Check Algorithm Used

as2_tostring

AS2 TO header of message

as2_fromstring

AS2 FROM header of message

message_idstring

AS2 Message Id

subjectstring

AS2 Subject Header

datestring

Date Header

body_sizestring

Encrypted Payload Body Size

attachment_filenamestring

Filename of the file being received.

ipstring

IP Address of the Sender

created_atstring date-time

Message creation date/time

http_response_codestring

HTTP Response Code sent for this message

http_response_headersobject

HTTP Headers sent for this message.

recipient_serialstring

Incoming Message Recipient(the Client Cert used to encrypt this message)'s serial

hex_recipient_serialstring

Incoming Message Recipient(the Client Cert used to encrypt this message)'s serial in hex format.

recipient_issuerstring

Incoming Message Recipient(the Client Cert used to encrypt this message)'s issuer

message_receivedboolean

Message body received?

message_decryptedboolean

Message decrypted successfully?

message_signature_verifiedboolean

Message signature verified?

message_processing_successboolean

Message processed successfully?

message_mdn_returnedboolean

MDN returned?

encrypted_uristring

URL to download the encrypted signed smime that is to sent as AS2 body

smime_signed_uristring

URL to download the file contents as smime with signature

smime_uristring

URL to download the file contents encoded as smime

raw_uristring

URL to download the original file contents

mdn_response_uristring

URL to download the http response body

Example response

[
  {
    "id": 1,
    "workspace_id": 1,
    "as2_partner_id": 1,
    "as2_station_id": 1,
    "uuid": "example",
    "content_type": "example",
    "http_headers": {
      "key": "example value"
    },
    "processing_result": "example",
    "processing_result_description": "example",
    "mic": "example",
    "mic_algo": "example",
    "as2_to": "example",
    "as2_from": "example",
    "message_id": "example",
    "subject": "example",
    "date": "example",
    "body_size": "example",
    "attachment_filename": "example",
    "ip": "example",
    "created_at": "2000-01-01T01:00:00Z",
    "http_response_code": "example",
    "http_response_headers": {
      "key": "example value"
    },
    "recipient_serial": "example",
    "hex_recipient_serial": "A5:EB:C1:95:DC:D8:2B:E7",
    "recipient_issuer": "example",
    "message_received": true,
    "message_decrypted": true,
    "message_signature_verified": true,
    "message_processing_success": true,
    "message_mdn_returned": true,
    "encrypted_uri": "example",
    "smime_signed_uri": "example",
    "smime_uri": "example",
    "raw_uri": "example",
    "mdn_response_uri": "example"
  }
]