curl --request GET \
--url 'https://edi.stateset.com/v1/partners/{id}/guide/versions' \
--header "Authorization: Bearer $STATESET_EDI_API_KEY"
[
{
"author": "string",
"created_at": "2026-08-31T14:22:05Z",
"note": "Two-person tent, green — replacement for damaged pole set.",
"overlay": {
"element_overrides": [],
"extra_segments": []
},
"partner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"tenant_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"validation": {
"accepted_inbound": [],
"conditional_rules": [],
"count_checks": {},
"element_constraints": [],
"required_qualified": {},
"required_references": {},
"required_segments": {},
"segment_cardinality": {}
},
"version": 1
}
]
Lists a partner's guide versions (oldest first).
Guide versions
GET
/
v1
/
partners
/
{id}
/
guide
/
versions
curl --request GET \
--url 'https://edi.stateset.com/v1/partners/{id}/guide/versions' \
--header "Authorization: Bearer $STATESET_EDI_API_KEY"
[
{
"author": "string",
"created_at": "2026-08-31T14:22:05Z",
"note": "Two-person tent, green — replacement for damaged pole set.",
"overlay": {
"element_overrides": [],
"extra_segments": []
},
"partner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"tenant_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"validation": {
"accepted_inbound": [],
"conditional_rules": [],
"count_checks": {},
"element_constraints": [],
"required_qualified": {},
"required_references": {},
"required_segments": {},
"segment_cardinality": {}
},
"version": 1
}
]
Path parameters
string
required
Partner ID
Response
GuideSnapshot[] — each element:
string
required
Who captured it (
admin, partner:{id}).string (date-time)
required
string
object
Show overlay
Show overlay
ElementOverride[]
string
required
string
required
PartnerValidation
required
Show PartnerValidation
Show PartnerValidation
string[]
If non-empty, inbound transaction sets not in this list are rejected (e.g.
['850', '860'] for a partner that only sends orders).ConditionalRule[]
If-then rules, e.g. ‘when BEG02 is SA, a DTM segment is required’.
object
Count-balancing rules per inbound transaction set —
CTT01 must equal the number of PO1 segments and friends. Checked only when the counter segment is present (pair with required_segments to mandate it).ElementConstraint[]
Element-level constraints applied to matching segments anywhere in an inbound document — e.g. pin PO1-03 (unit of measure) to an allowed set.
Show ElementConstraint
Show ElementConstraint
string[]
If non-empty, the element must be one of these values.
integer
required
1-based element position, e.g.
3 for the PO1 unit of measure.object
integer
Maximum length (in characters) when the element is present.
integer
Minimum length (in characters) when the element is present.
boolean
If true, the element must be present (non-empty).
string
required
Segment tag, e.g.
PO1.object
Qualified-segment requirements per inbound transaction set — the guide staple
required_references can’t reach beyond REF: ‘a DTM*002 (delivery date) must be present’, ‘an N1 loop with N101=ST’. The '*' key applies to every set.object
REF qualifiers that must be present per inbound transaction set, e.g.
{'850': ['DP']} to require a department-number reference on every PO.object
Segment tags that must be present per inbound transaction set, e.g.
{'850': ['DTM', 'REF']} to require a date and reference on every PO. The '*' key applies to every inbound set.object
Occurrence bounds per inbound transaction set, e.g.
{'850': [{'segment': 'BEG', 'min': 1, 'max': 1}]} for ‘exactly one BEG’ or a guide’s ‘max 200 PO1 lines’. The '*' key applies to every set; a set-specific rule for the same segment takes precedence.integer (int32)
required
Monotonic version, starting at 1.
Status codes
| Code | Meaning |
|---|---|
200 | Guide versions |
curl --request GET \
--url 'https://edi.stateset.com/v1/partners/{id}/guide/versions' \
--header "Authorization: Bearer $STATESET_EDI_API_KEY"
[
{
"author": "string",
"created_at": "2026-08-31T14:22:05Z",
"note": "Two-person tent, green — replacement for damaged pole set.",
"overlay": {
"element_overrides": [],
"extra_segments": []
},
"partner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"tenant_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"validation": {
"accepted_inbound": [],
"conditional_rules": [],
"count_checks": {},
"element_constraints": [],
"required_qualified": {},
"required_references": {},
"required_segments": {},
"segment_cardinality": {}
},
"version": 1
}
]
Last modified on August 31, 2026