For the complete documentation index, see llms.txt. This page is also available as Markdown.

List journal charges

Retrieves a list of charges for a specific journal.

get

Returns all charges associated with the journal. Supports JSONL export for operations (Accept: application/jsonl). Supports filtering, sorting, and pagination via query parameters.

Path parameters
journalIdstringRequired
Responses
200

OK

application/json
get/public/v1/billing/journals/{journalId}/charges
GET /public/v1/billing/journals/{journalId}/charges HTTP/1.1
Host: api.platform.softwareone.com
Accept: */*
200

OK

{
  "$meta": {
    "pagination": {
      "offset": 1,
      "limit": 1,
      "total": 1
    },
    "omitted": [
      "text"
    ]
  },
  "data": [
    {
      "audit": {
        "reconciled": {
          "at": "2026-01-01T00:00:00.000Z",
          "by": {
            "id": "text",
            "name": "text",
            "icon": "text",
            "revision": 1
          }
        },
        "reset": {
          "at": "2026-01-01T00:00:00.000Z",
          "by": {
            "id": "text",
            "name": "text",
            "icon": "text",
            "revision": 1
          }
        }
      },
      "$meta": {
        "omitted": [
          "text"
        ]
      },
      "revision": 1,
      "id": "CHG-1234-1234-1234-1234-1234",
      "externalIds": {
        "reference": "REF-67890",
        "invoice": "INV-12345",
        "vendor": "VND-54321"
      },
      "search": {
        "source": {
          "criteria": "externalIds.Vendor",
          "value": "EXT-12345",
          "type": "Subscription"
        },
        "order": {
          "criteria": "externalIds.Vendor",
          "value": "EXT-12345"
        },
        "item": {
          "criteria": "externalIds.Vendor",
          "value": "EXT-12345"
        }
      },
      "period": {
        "start": "2025-01-01T00:00:00+00:00",
        "end": "2025-01-31T23:59:59+00:00"
      },
      "quantity": 10.5,
      "price": {
        "currency": {
          "purchase": "USD",
          "sale": "EUR",
          "rate": 1
        },
        "markup": 15.5,
        "markupSource": "Line",
        "margin": 20,
        "unitPP": 100,
        "PPx1": 1000,
        "unitBSP": 120,
        "BSPx1": 1200,
        "unitSP": 120,
        "SPx1": 1200
      },
      "description": {
        "value1": "Monthly subscription charge",
        "value2": "Includes additional services"
      },
      "attributes": {
        "documentNumber": "DOC-12345",
        "orderType": "PurchaseOrder",
        "externalDocumentNo": "EXT-67890",
        "externalDocumentNo2": "EXT2-54321",
        "yourReference": "CUST-REF-001",
        "agreementVendorId": "170ec08e-f43c-4831-aeb2-0d6455e1acf5",
        "segment": "Segment-A"
      },
      "journal": {
        "revision": 1,
        "id": "BJO-1234-1234",
        "name": "29 Nov 2024 #1",
        "dueDate": "2025-05-15T23:59:59+00:00"
      },
      "ledger": {
        "revision": 1,
        "id": "BLE-1234-1234-1234-1234"
      },
      "customLedger": {
        "revision": 1,
        "id": "text",
        "name": "Quarterly Revenue Ledger"
      },
      "parent": {
        "revision": 1,
        "id": "CHG-1234-1234-1234-1234-1234",
        "externalIds": {
          "reference": "REF-67890",
          "invoice": "INV-12345",
          "vendor": "VND-54321"
        }
      },
      "billingType": "Automated",
      "upload": {
        "status": "Ready",
        "errors": [
          "Invalid charge amount",
          "Missing buyer information"
        ]
      },
      "licensee": {
        "id": "text",
        "name": "text",
        "icon": "text",
        "revision": 1,
        "externalId": "text"
      },
      "agreement": {
        "id": "text",
        "name": "text",
        "icon": "text",
        "revision": 1,
        "status": "New"
      },
      "subscription": {
        "id": "text",
        "name": "text",
        "revision": 1
      },
      "line": {
        "id": "text",
        "audit": {
          "created": {
            "at": "2026-01-01T00:00:00.000Z",
            "by": {
              "id": "text",
              "name": "text",
              "icon": "text",
              "revision": 1
            }
          },
          "updated": {
            "at": "2026-01-01T00:00:00.000Z",
            "by": {
              "id": "text",
              "name": "text",
              "icon": "text",
              "revision": 1
            }
          },
          "terminated": {
            "at": "2026-01-01T00:00:00.000Z",
            "by": {
              "id": "text",
              "name": "text",
              "icon": "text",
              "revision": 1
            }
          },
          "deleted": {
            "at": "2026-01-01T00:00:00.000Z",
            "by": {
              "id": "text",
              "name": "text",
              "icon": "text",
              "revision": 1
            }
          }
        },
        "quantity": 1,
        "item": {
          "id": "text",
          "audit": {
            "created": {
              "at": "2026-01-01T00:00:00.000Z",
              "by": {
                "id": "text",
                "name": "text",
                "icon": "text",
                "revision": 1
              }
            },
            "updated": {
              "at": "2026-01-01T00:00:00.000Z",
              "by": {
                "id": "text",
                "name": "text",
                "icon": "text",
                "revision": 1
              }
            },
            "pending": {
              "at": "2026-01-01T00:00:00.000Z",
              "by": {
                "id": "text",
                "name": "text",
                "icon": "text",
                "revision": 1
              }
            },
            "published": {
              "at": "2026-01-01T00:00:00.000Z",
              "by": {
                "id": "text",
                "name": "text",
                "icon": "text",
                "revision": 1
              }
            },
            "unpublished": {
              "at": "2026-01-01T00:00:00.000Z",
              "by": {
                "id": "text",
                "name": "text",
                "icon": "text",
                "revision": 1
              }
            }
          },
          "$meta": {
            "omitted": [
              "text"
            ]
          },
          "name": "text",
          "revision": 1,
          "description": "text",
          "externalIds": {
            "vendor": "text",
            "operations": "text"
          },
          "group": {
            "id": "text",
            "name": "text",
            "revision": 1
          },
          "unit": {
            "id": "text",
            "name": "text",
            "revision": 1,
            "description": "text"
          },
          "terms": {
            "model": "one-time",
            "period": "1m",
            "commitment": "1m"
          },
          "quantityNotApplicable": true,
          "status": "text",
          "product": {
            "id": "text",
            "name": "text",
            "icon": "text",
            "revision": 1,
            "externalIds": {
              "operations": "text",
              "defaultErpItem": "text"
            },
            "status": "text"
          },
          "parameters": [
            {
              "id": "text",
              "externalId": "text",
              "type": "text",
              "multiple": true,
              "name": "text",
              "value": null,
              "displayValue": "text"
            }
          ]
        },
        "price": {
          "currency": "text",
          "markup": 1,
          "margin": 1,
          "defaultMarkupSource": {
            "type": "text",
            "ref": {
              "id": "text",
              "name": "text"
            }
          },
          "markupSource": {
            "type": "text",
            "ref": {
              "id": "text",
              "name": "text"
            }
          },
          "unitSP": 1,
          "unitPP": 1,
          "PPx1": 1,
          "SPx1": 1,
          "SPxY": 1,
          "SPxM": 1,
          "PPxY": 1,
          "PPxM": 1
        },
        "order": "[Circular Reference]",
        "status": "Active",
        "subscription": "[Circular Reference]",
        "asset": "[Circular Reference]",
        "agreement": "[Circular Reference]",
        "client": {
          "id": "text",
          "audit": {
            "created": {
              "at": "2026-01-01T00:00:00.000Z",
              "by": {
                "id": "text",
                "name": "text",
                "icon": "text",
                "revision": 1
              }
            },
            "updated": {
              "at": "2026-01-01T00:00:00.000Z",
              "by": {
                "id": "text",
                "name": "text",
                "icon": "text",
                "revision": 1
              }
            }
          },
          "$meta": {
            "omitted": [
              "text"
            ]
          },
          "name": "text",
          "icon": "text",
          "revision": 1,
          "type": "Client",
          "status": "Active",
          "externalIds": {
            "pyraTenantId": "123e4567-e89b-12d3-a456-426614174000"
          },
          "externalId": "text",
          "externalName": "text",
          "address": {
            "addressLine1": "text",
            "addressLine2": "text",
            "postCode": "text",
            "city": "text",
            "state": "text",
            "country": "text"
          },
          "technicalSupportEmail": "text",
          "website": "text",
          "description": "text",
          "groups": [
            {
              "id": "text",
              "name": "text",
              "revision": 1,
              "description": "text",
              "logo": "text",
              "isDefault": true
            }
          ],
          "eligibility": {
            "client": true,
            "partner": true
          },
          "defaultLanguageCode": "text"
        },
        "vendor": {
          "id": "text",
          "audit": {
            "created": {
              "at": "2026-01-01T00:00:00.000Z",
              "by": {
                "id": "text",
                "name": "text",
                "icon": "text",
                "revision": 1
              }
            },
            "updated": {
              "at": "2026-01-01T00:00:00.000Z",
              "by": {
                "id": "text",
                "name": "text",
                "icon": "text",
                "revision": 1
              }
            }
          },
          "$meta": {
            "omitted": [
              "text"
            ]
          },
          "name": "text",
          "icon": "text",
          "revision": 1,
          "type": "Client",
          "status": "Active",
          "externalIds": {
            "pyraTenantId": "123e4567-e89b-12d3-a456-426614174000"
          },
          "externalId": "text",
          "externalName": "text",
          "address": {
            "addressLine1": "text",
            "addressLine2": "text",
            "postCode": "text",
            "city": "text",
            "state": "text",
            "country": "text"
          },
          "technicalSupportEmail": "text",
          "website": "text",
          "description": "text",
          "groups": [
            {
              "id": "text",
              "name": "text",
              "revision": 1,
              "description": "text",
              "logo": "text",
              "isDefault": true
            }
          ],
          "eligibility": {
            "client": true,
            "partner": true
          },
          "defaultLanguageCode": "text"
        },
        "buyer": {
          "id": "text",
          "audit": {
            "created": {
              "at": "2026-01-01T00:00:00.000Z",
              "by": {
                "id": "text",
                "name": "text",
                "icon": "text",
                "revision": 1
              }
            },
            "updated": {
              "at": "2026-01-01T00:00:00.000Z",
              "by": {
                "id": "text",
                "name": "text",
                "icon": "text",
                "revision": 1
              }
            },
            "activated": {
              "at": "2026-01-01T00:00:00.000Z",
              "by": {
                "id": "text",
                "name": "text",
                "icon": "text",
                "revision": 1
              }
            },
            "unassigned": {
              "at": "2026-01-01T00:00:00.000Z",
              "by": {
                "id": "text",
                "name": "text",
                "icon": "text",
                "revision": 1
              }
            },
            "disabled": {
              "at": "2026-01-01T00:00:00.000Z",
              "by": {
                "id": "text",
                "name": "text",
                "icon": "text",
                "revision": 1
              }
            }
          },
          "$meta": {
            "omitted": [
              "text"
            ]
          },
          "name": "text",
          "icon": "text",
          "revision": 1,
          "externalIds": {
            "erpCompanyContact": "text",
            "erpCustomer": "text",
            "accountExternalId": "text"
          },
          "status": "Active",
          "address": {
            "addressLine1": "text",
            "addressLine2": "text",
            "postCode": "text",
            "city": "text",
            "state": "text",
            "country": "text"
          },
          "taxId": "text",
          "account": {
            "id": "text",
            "name": "text",
            "icon": "text",
            "revision": 1,
            "type": "Client",
            "status": "Active"
          },
          "errors": [
            {
              "id": "text",
              "message": "text",
              "parameters": null
            }
          ],
          "sellers": [
            {
              "id": "text",
              "name": "text",
              "icon": "text",
              "revision": 1,
              "externalId": "text"
            }
          ]
        },
        "seller": {
          "id": "text",
          "audit": {
            "created": {
              "at": "2026-01-01T00:00:00.000Z",
              "by": {
                "id": "text",
                "name": "text",
                "icon": "text",
                "revision": 1
              }
            },
            "updated": {
              "at": "2026-01-01T00:00:00.000Z",
              "by": {
                "id": "text",
                "name": "text",
                "icon": "text",
                "revision": 1
              }
            }
          },
          "$meta": {
            "omitted": [
              "text"
            ]
          },
          "name": "text",
          "icon": "text",
          "revision": 1,
          "externalId": "text",
          "status": "Active",
          "currencies": [
            {
              "value": "text",
              "billingEnabled": true,
              "isDefault": true
            }
          ],
          "address": {
            "addressLine1": "text",
            "addressLine2": "text",
            "postCode": "text",
            "city": "text",
            "state": "text",
            "country": "text"
          },
          "erpLink": {
            "id": "text",
            "name": "text",
            "icon": "text",
            "revision": 1,
            "companyName": "text",
            "status": "Active"
          },
          "attributes": {
            "navision": null
          }
        },
        "product": {
          "id": "text",
          "audit": {
            "created": {
              "at": "2026-01-01T00:00:00.000Z",
              "by": {
                "id": "text",
                "name": "text",
                "icon": "text",
                "revision": 1
              }
            },
            "updated": {
              "at": "2026-01-01T00:00:00.000Z",
              "by": {
                "id": "text",
                "name": "text",
                "icon": "text",
                "revision": 1
              }
            },
            "published": {
              "at": "2026-01-01T00:00:00.000Z",
              "by": {
                "id": "text",
                "name": "text",
                "icon": "text",
                "revision": 1
              }
            },
            "pending": {
              "at": "2026-01-01T00:00:00.000Z",
              "by": {
                "id": "text",
                "name": "text",
                "icon": "text",
                "revision": 1
              }
            },
            "unpublished": {
              "at": "2026-01-01T00:00:00.000Z",
              "by": {
                "id": "text",
                "name": "text",
                "icon": "text",
                "revision": 1
              }
            }
          },
          "$meta": {
            "omitted": [
              "text"
            ]
          },
          "name": "text",
          "icon": "text",
          "revision": 1,
          "shortDescription": "text",
          "longDescription": "text",
          "externalIds": {
            "operations": "text",
            "defaultErpItem": "text"
          },
          "website": "text",
          "status": "text",
          "vendor": {
            "id": "text",
            "name": "text",
            "icon": "text",
            "revision": 1,
            "type": "Client",
            "status": "Active"
          },
          "settings": {
            "productOrdering": true,
            "productRequests": {
              "enabled": true,
              "name": "text",
              "label": "text"
            },
            "itemSelection": true,
            "orderQueueChanges": true,
            "preValidation": {
              "purchaseOrderDraft": true,
              "purchaseOrderQuerying": true,
              "changeOrderDraft": true,
              "configurationOrderDraft": true,
              "terminationOrder": true
            },
            "splitBilling": {
              "enabled": true,
              "type": "text"
            },
            "sendCostToErp": true,
            "subscriptionCessation": {
              "enabled": true,
              "mode": "Termination"
            }
          },
          "statistics": {
            "itemCount": 1,
            "ordersPlacedCount": 1,
            "agreementCount": 1,
            "subscriptionCount": 1
          }
        },
        "description": "text",
        "info": {
          "visible": true,
          "description": "text"
        }
      },
      "order": {
        "id": "text",
        "revision": 1
      },
      "asset": {
        "id": "text",
        "name": "text",
        "revision": 1,
        "status": "New"
      },
      "item": {
        "id": "text",
        "name": "text",
        "revision": 1,
        "externalIds": {
          "vendor": "text",
          "operations": "text"
        }
      },
      "authorization": {
        "id": "text",
        "name": "text",
        "revision": 1,
        "currency": "text"
      },
      "statement": {
        "revision": 1,
        "id": "SOM-1234-1234-1234-1234-1234"
      },
      "statementType": "Debit",
      "processing": {
        "status": "Ready",
        "errors": [
          "Invalid charge amount",
          "Missing buyer information"
        ]
      },
      "erpData": {
        "erpCountryCode": "US",
        "defaultErpProductId": "PROD-12345",
        "defaultErpProductName": "Standard Product",
        "cdg": "CDG-001",
        "scu": "SCU-123",
        "cco": "CCO-456",
        "erpItemId": "ITEM-789"
      },
      "buyer": {
        "id": "text",
        "name": "text",
        "icon": "text",
        "revision": 1
      },
      "vendor": {
        "id": "text",
        "name": "text",
        "icon": "text",
        "revision": 1,
        "type": "Client",
        "status": "Active"
      },
      "seller": {
        "id": "text",
        "name": "text",
        "icon": "text",
        "revision": 1,
        "externalId": "text"
      },
      "split": {
        "percentage": 50
      },
      "reconciliation": {
        "type": "Match",
        "source": "Unknown",
        "reason": "text",
        "original": "[Circular Reference]"
      }
    }
  ]
}

Last updated

Was this helpful?