How do I attach multiple files in one transaction?

Unsolicited and Solicited transactions use different approaches for attaching multiple files. Both transaction types support this feature.

You use the serviceLines object to contain two or more sub-objects in the JSON request body, each representing an attachment file. Each attached document requires its own record as part of the transaction (you can't just list the filenames under attachmentDetails).

For Unsolicited Attachments transactions, each attachment must have a unique providerAttachmentControlNumber value. Here's an example:

    "serviceLines": [{
      "providerAttachmentControlNumber": "123456789",
      "serviceLineDateInformation" : {
          "submissionDate" : "20050514"
      },
      "attachmentDetails": {
        "name": "rightarm.jpg"
      }
    }
    {
      "providerAttachmentControlNumber": "123456788",
      "serviceLineDateInformation" : {
          "submissionDate" : "20050514"
      },
      "attachmentDetails": {
        "name": "rightscapula.jpg"
      }
    }]

For Solicited Attachments transactions, you use the payerClaimControlNumber in the JSON request body and use the same payerClaimControlNumber value in each document record:

    "serviceLines": [{
      "payerClaimControlNumber": "123412341",
      "serviceLineDateInformation" : {
          "submissionDate" : "20050514"
      },
      "attachmentDetails": {
        "name": "rightarm.jpg"
      }
    }
    {
      "payerClaimControlNumber": "123412341",
      "serviceLineDateInformation" : {
          "submissionDate" : "20050514"
      },
      "attachmentDetails": {
        "name": "rightscapula.jpg"
      }]
  }