---
updatedAt: 2026-05-04T20:47:50.000Z
---

Fetch the complete documentation index at: https://developers.pismo.io/pismo-docs/llms.txt. Use this file to discover all available pages before exploring further.

# Get program export record

Gets a program's detailed export record, including the export steps and their statuses.


# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Platform setup - Programs",
    "description": "Endpoints to handle Programs",
    "version": "v1.0",
    "contact": {
      "name": "Pismo Support",
      "url": "https://developers.pismo.io/support/"
    },
    "license": {
      "name": "Copyright Pismo"
    }
  },
  "servers": [
    {
      "url": "https://sandbox.pismolabs.io",
      "description": "Sandbox API server for testing"
    }
  ],
  "tags": [
    {
      "name": "Export and import",
      "description": "Export and import programs"
    }
  ],
  "components": {
    "parameters": {
      "ProgramExportIdPath": {
        "description": "Exported program ID",
        "in": "path",
        "name": "id",
        "required": true,
        "schema": {
          "type": "integer",
          "format": "int64"
        },
        "example": 12345
      }
    },
    "schemas": {
      "ExportCreatedAt": {
        "type": "string",
        "description": "Program export creation datetime. Format = yyyy-mm-ddThh:mm:ss.",
        "example": "2023-07-10 15:30:14"
      },
      "ExporterDetails": {
        "type": "string",
        "description": "Program exporter details",
        "example": "Details of program export 484"
      },
      "ExportFileUrl": {
        "type": "string",
        "description": "File URL for download export",
        "example": "export/TN-00001/484/export.json"
      },
      "ExportFinishedAt": {
        "type": "string",
        "description": "Datetime when program export finished. Format = yyyy-mm-ddThh:mm:ss.",
        "example": "2023-07-10 18:31:18"
      },
      "ExportStepDetails": {
        "type": "string",
        "description": "Export step details",
        "example": "Export step details"
      },
      "ExportStepID": {
        "type": "integer",
        "format": "int32",
        "description": "Program export step ID",
        "example": 45
      },
      "ExportStepOrder": {
        "type": "integer",
        "format": "int32",
        "description": "Program export step order, with `1` as the highest.",
        "example": 1
      },
      "ExportStepStatus": {
        "type": "string",
        "description": "Program export step status",
        "enum": [
          "PENDING",
          "PROCESS",
          "SUCCESS",
          "ERROR"
        ],
        "example": "PENDING"
      },
      "handler.HTTPError": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "Bad request code",
            "example": "EOA0017"
          },
          "message": {
            "type": "string",
            "description": "Bad request response",
            "example": "Bad Request"
          }
        }
      },
      "ImportExportStepName": {
        "type": "string",
        "description": "Program export step name\n\nSteps per [program type](https://developers.pismo.io/pismo-docs/docs/program-types): \n\nKey: FBC = Full balance (FB) credit, ZBC = Zero balance (ZB) credit, FBD = FB debit, ZBD = ZB debit, FBPP = FB pre-paid, ZBPP= ZB pre-paid, Corp = Corporate\n\n| Step | FBC | ZBC | FBD | ZBD | FBPP | ZBPP| Corp |\n| ------------------------------|---|---|---|---|---|---|---|\n| `PROGRAM` | X | X | X | X | X | X | X |\n| `DUEDATES` | X |  |  |  |  |  |  |\n| `CHANNELS` | X | X | X | X | X | X |  |\n| `PROGRAMS_PARAMETERS` | X | X | X | X | X | X | X |\n| `TRANSACTIONS_CATEGORIES` | X |  |  |  |  |  |  |\n| `PROGRAMS_TRANSACTION_TYPES` | X |  |  |  |  |  |  |\n| `ORGS_OPERATIONS` | X |  | X |  | X |  | X |\n| `NETWORK_ACCEPTANCES` | X | X |  |  |  |  |  |\n",
        "enum": [
          "PROGRAM",
          "DUEDATES",
          "CHANNELS",
          "PROGRAMS_PARAMETERS",
          "TRANSACTIONS_CATEGORIES",
          "PROGRAMS_TRANSACTION_TYPES",
          "ORGS_OPERATIONS",
          "NETWORK_ACCEPTANCES"
        ],
        "maxLength": 50,
        "example": "PROGRAM"
      },
      "ProgramExporterID": {
        "type": "integer",
        "format": "int64",
        "description": "Program exporter ID",
        "example": 12
      },
      "ProgramExporterStatus": {
        "type": "string",
        "description": "Program exporter status",
        "enum": [
          "PENDING",
          "PROCESS",
          "SUCCESS",
          "ERROR"
        ],
        "example": "SUCCESS"
      },
      "ProgramExportSteps": {
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/ExportStepID"
          },
          "name": {
            "$ref": "#/components/schemas/ImportExportStepName"
          },
          "status": {
            "$ref": "#/components/schemas/ExportStepStatus"
          },
          "order": {
            "$ref": "#/components/schemas/ExportStepOrder"
          },
          "details": {
            "$ref": "#/components/schemas/ExportStepDetails"
          },
          "started_at": {
            "$ref": "#/components/schemas/StepStartedAt"
          },
          "finished_at": {
            "$ref": "#/components/schemas/StepFinishedAt"
          },
          "deleted_at": {
            "$ref": "#/components/schemas/StepDeletedAt"
          }
        }
      },
      "ProgramExportWithStepResponse": {
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/ProgramExporterID"
          },
          "program_id": {
            "$ref": "#/components/schemas/ProgramID"
          },
          "status": {
            "$ref": "#/components/schemas/ProgramExporterStatus"
          },
          "file_url": {
            "$ref": "#/components/schemas/ExportFileUrl"
          },
          "details": {
            "$ref": "#/components/schemas/ExporterDetails"
          },
          "started_at": {
            "$ref": "#/components/schemas/ExportCreatedAt"
          },
          "finished_at": {
            "$ref": "#/components/schemas/ExportFinishedAt"
          },
          "program_export_steps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProgramExportSteps"
            }
          }
        }
      },
      "ProgramID": {
        "type": "integer",
        "format": "int64",
        "description": "Program ID",
        "example": 12345
      },
      "StepDeletedAt": {
        "type": "string",
        "description": "Step deletion datetime. Format = yyyy-mm-ddThh:mm:ss.",
        "example": "2021-09-23T10:10:25Z"
      },
      "StepFinishedAt": {
        "type": "string",
        "description": "Step completion datetime. Format = yyyy-mm-ddThh:mm:ss.",
        "example": "2021-09-23T10:15:45Z"
      },
      "StepStartedAt": {
        "type": "string",
        "description": "Step start datetime. Format = yyyy-mm-ddThh:mm:ss.",
        "example": "2021-09-23T10:05:00Z"
      }
    },
    "responses": {
      "404NotFound": {
        "description": "Not Found",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/handler.HTTPError"
            }
          }
        }
      }
    },
    "examples": {
      "GenericError2Response": {
        "value": {
          "code": "EOA0016",
          "message": "Something went wrong, please try again later"
        }
      },
      "GenericErrorResponse": {
        "value": {
          "code": "EOA0015",
          "message": "Something went wrong, please try again later"
        }
      },
      "ProgramExportNotFoundResponse": {
        "value": {
          "code": "EOA0072",
          "message": "Program export xxx not found"
        }
      },
      "ProgramExportStepsNotFoundResponse": {
        "value": {
          "code": "EOA0090",
          "message": "Steps for program export xxx not found"
        }
      }
    },
    "securitySchemes": {
      "S2SAuthentication": {
        "type": "http",
        "scheme": "bearer",
        "description": "All requests must be previoulsy authenticated."
      }
    }
  },
  "security": [
    {
      "S2SAuthentication": []
    }
  ],
  "paths": {
    "/programs/v1/programs/export/{id}": {
      "get": {
        "summary": "Get program export record",
        "description": "Gets a program's detailed export record, including the export steps and their statuses.\n",
        "operationId": "getProgramExportRecord",
        "tags": [
          "Export and import"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/ProgramExportIdPath"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProgramExportWithStepResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/handler.HTTPError"
                },
                "examples": {
                  "program-export-not-found": {
                    "$ref": "#/components/examples/ProgramExportNotFoundResponse"
                  },
                  "program-export-steps-not-found": {
                    "$ref": "#/components/examples/ProgramExportStepsNotFoundResponse"
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/handler.HTTPError"
                },
                "examples": {
                  "generic-error": {
                    "$ref": "#/components/examples/GenericErrorResponse"
                  },
                  "generic-error-2": {
                    "$ref": "#/components/examples/GenericError2Response"
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```