Issuance

Overview

Submitting a SAFc Issuance request requires uploading a supporting document (including a POS/POC and a PTD appended together) and then performing a form submission that refers to the document upload. We recommend familiarizing yourself with using the UI to perform issuances so you know how to structure your API requests.

File Upload

Upload your supporting document first with this request URL: https://safcregistry.energyweb.org/api/file

You'll need to provide request headers including the bearer token and refere e.g.

https://safcregistry.energyweb.org/holdings?accountId=cd863a81-156d-483e-ade5-bc0122856a7d&page=0&selectedTab=issuanceTable&limit=10

The payload is a binary file that must be PDF or CSV of max size 10 MB

Here's a sample response for a successful upload:

{
    "id": "414fdcd0-87b7-41e2-ba98-cf02b3e3cf1e",
    "name": "POS-2023-1-22.csv",
    "mimetype": "application/octet-stream",
    "size": 90,
    "createdAt": "2025-06-26T19:20:42.245Z"
}

Record the ID

Form Submission

Use this URL for the form submission: https://safcregistry.energyweb.org/api/unit-process/issue

Here's a sample payload for a successful issuance:

{
  "type": "SAFcA",
  "assuranceLevel": "VAL",
  "accountId": "cd863a81-156d-483e-ade5-bc0122856a7d",
  "documentationType": "pos",
  "fileTool": "414fdcd0-87b7-41e2-ba98-cf02b3e3cf1e",
  "batch": {
    "companyName": "X Fuels",
    "fuelProviderCompanyName": "X Fuels",
    "leaveDate": "2025-05-13",
    "batchNumber": "12345",
    "productionYear": 2024,
    "upliftCountry": {
      "name": "United Kingdom",
      "code": "GB"
    },
    "upliftAirport": "London Heathrow",
    "regulatorySchemesDeclaration": [
      "US RFS RINs"
    ]
  },
  "blending": {
    "isBlended": true,
    "blendingDate": "2024-11-20",
    "blendingLocation": {
      "addressLine": "1234 Main St",
      "city": "Austin",
      "state": "TX",
      "postalCode": "78731",
      "country": {
        "name": "United States of America",
        "code": "US"
      }
    }
  },
  "supplier": {
    "siteName": "X Co",
    "siteAddress": {
      "addressLine": "1234 Main St",
      "city": "Austin",
      "state": "TX",
      "postalCode": "78731",
      "country": {
        "name": "United States of America",
        "code": "US"
      }
    }
  },
  "certification": {
    "scheme": "isccEu",
    "type": "actual",
    "certificateNumber": "12345",
    "certificationBody": "CSC",
    "expiryDate": "2025-11-01",
    "certificationBodyEmail": "[email protected]",
    "traderCertificationNumber": "123456",
    "additionalScheme": "",
    "isLowILUCRiskConfirmed": false,
    "isLowDisplacementRiskConfirmed": false
  },
  "product": {
    "feedStock": {
      "name": "animalFatsOilsAndOther",
      "isSolidWaste": false,
      "wasCertifiedAsProductionResidue": true
    },
    "quantityMT": 100,
    "countries": [
      {
        "name": "United States of America",
        "code": "US"
      }
    ],
    "conversionProcess": "hefa",
    "lowerHeatingValue": 44.34,
    "jetFuelBaselineCarbonIntensity": "94g"
  },
  "greenhouseGas": {
    "totalLCAValueEuActual": 12.9,
    "inducedLandUseChange": 0,
    "extractionEmissions": 0,
    "annualisedEmissions": 0,
    "processingEmissions": 11.17,
    "transportEmissions": 1.7,
    "inUseFuelEmissions": 0,
    "savingsFromSoil": 0,
    "savingsFromCarbonAndStorage": 0,
    "savingsFromCarbonAndReplacement": 0,
    "savingsFromExcess": 0,
    "totalLCAValueincludeEmissionsFromDeliveryToAirport": true
  }
}

Note the "fileTool" ID is what links the file upload to the form submission

The response to the successful submission contains the operation ID:

{"operationId":"5c77cdf9-099a-4962-bf66-1c78306619c1"}